다음을 통해 공유

DataLakeDirectoryClient 클래스

  • 참조

디렉터리가 아직 없는 경우에도 DataLake 디렉터리와 상호 작용할 클라이언트입니다.

디렉터리 아래의 특정 하위 디렉터리 또는 파일과 관련된 작업의 경우 또는 get_file_client 함수를 사용하여 디렉터리 클라이언트 또는 파일 클라이언트를 get_sub_directory_client 검색할 수 있습니다.

상속
azure.storage.filedatalake._path_client.PathClient
DataLakeDirectoryClient

생성자

DataLakeDirectoryClient(account_url: str, file_system_name: str, directory_name: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any)

매개 변수

account_url
str
필수

스토리지 계정에 대한 URI입니다.

file_system_name
str
필수

디렉터리 또는 파일의 파일 시스템입니다.

directory_name
str
필수

디렉터리의 전체 경로입니다. 예: {파일 시스템 아래의 디렉터리}/{상호 작용할 디렉터리}

credential
기본값: None

인증할 자격 증명입니다. 계정 URL에 이미 SAS 토큰이 있는 경우 선택 사항입니다. 값은 SAS 토큰 문자열, azure.core.credentials의 AzureSasCredential 또는 AzureNamedKeyCredential의 instance, 계정 공유 액세스 키 또는 azure.identity에서 TokenCredentials 클래스의 instance 수 있습니다. 리소스 URI에 이미 SAS 토큰이 포함된 경우 명시적 자격 증명을 위해 무시됩니다.

  • 충돌하는 SAS 토큰이 ValueError를 발생시키는 AzureSasCredential의 경우를 제외하고 AzureNamedKeyCredential의 instance 사용하는 경우 "name"은 스토리지 계정 이름이고 "키"는 스토리지 계정 키여야 합니다.
api_version
str

요청에 사용할 Storage API 버전입니다. 기본값은 현재 SDK와 호환되는 최신 서비스 버전입니다. 이전 버전으로 설정하면 기능 호환성이 저하될 수 있습니다.

예제

연결 문자열에서 DataLakeServiceClient 만들기


   from azure.storage.filedatalake import DataLakeDirectoryClient
   DataLakeDirectoryClient.from_connection_string(connection_string, "myfilesystem", "mydirectory")

변수

url
str

사용되는 경우 SAS 토큰을 포함하여 파일 시스템에 대한 전체 엔드포인트 URL입니다.

primary_endpoint
str

전체 기본 엔드포인트 URL입니다.

primary_hostname
str

기본 엔드포인트의 호스트 이름입니다.

메서드

acquire_lease

새로운 임대를 요청합니다. 파일 또는 디렉터리에 활성 임대가 없는 경우 DataLake 서비스는 파일/디렉터리에 임대를 만들고 새 임대 ID를 반환합니다.
close

이 방법은 클라이언트가 연 소켓을 닫는 것입니다. 컨텍스트 관리자와 함께 사용할 때 사용할 필요가 없습니다.
create_directory

새 디렉터리를 만듭니다.
create_file

새 파일을 만들고 상호 작용할 파일 클라이언트를 반환합니다.
create_sub_directory

하위 디렉터리를 만들고 상호 작용할 하위 디렉터리 클라이언트를 반환합니다.
delete_directory

삭제할 지정된 디렉터리를 표시합니다.
delete_sub_directory

삭제할 지정된 하위 디렉터리를 표시합니다.
exists

디렉터리가 있으면 True를 반환하고, 그렇지 않으면 False를 반환합니다.
from_connection_string

연결 문자열에서 DataLakeDirectoryClient를 만듭니다.
get_access_control
get_directory_properties

디렉터리에 대한 모든 사용자 정의 메타데이터, 표준 HTTP 속성 및 시스템 속성을 반환합니다. 디렉터리의 콘텐츠를 반환하지 않습니다.
get_file_client

지정된 파일과 상호 작용할 클라이언트를 가져옵니다.

파일이 아직 필요하지 않습니다.
get_sub_directory_client

현재 디렉터리의 지정된 하위 디렉터리와 상호 작용할 클라이언트를 가져옵니다.

하위 디렉터리가 아직 필요하지 않습니다.
remove_access_control_recursive

경로 및 하위 경로의 Access Control 제거합니다.
rename_directory

원본 디렉터리의 이름을 바꿉니다.
set_access_control

경로에 대한 소유자, 그룹, 권한 또는 액세스 제어 목록을 설정합니다.
set_access_control_recursive

경로 및 하위 경로의 Access Control 설정합니다.
set_http_headers

파일 또는 디렉터리의 시스템 속성을 설정합니다.

content_settings 대해 하나의 속성이 설정된 경우 모든 속성이 재정의됩니다.
set_metadata

지정된 파일 시스템에 대해 하나 이상의 사용자 정의 이름-값 쌍을 설정합니다. 이 작업에 대한 각 호출은 파일 시스템에 연결된 모든 기존 메타데이터를 대체합니다. 파일 시스템에서 모든 메타데이터를 제거하려면 메타데이터 받아쓰기 없이 이 작업을 호출합니다.
update_access_control_recursive

경로 및 하위 경로의 Access Control 수정합니다.

acquire_lease

새로운 임대를 요청합니다. 파일 또는 디렉터리에 활성 임대가 없는 경우 DataLake 서비스는 파일/디렉터리에 임대를 만들고 새 임대 ID를 반환합니다.

acquire_lease(lease_duration: int | None = -1, lease_id: str | None = None, **kwargs) -> DataLakeLeaseClient

매개 변수

lease_duration
int
필수

임대 기간(초)을 지정하거나 만료되지 않는 임대의 경우 -1을 지정합니다. 가능한 유한 임대 기간은 15~60초 사이입니다. 갱신 또는 변경을 사용하여 임대 기간을 변경할 수 없습니다. 기본값은 -1(무한 임대)입니다.

lease_id
str
필수

GUID 문자열 형식의 제안된 임대 ID입니다. 제안된 임대 ID가 올바른 형식이 아닌 경우 DataLake 서비스는 400(잘못된 요청)을 반환합니다.

if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

컨텍스트 관리자에서 실행할 수 있는 DataLakeLeaseClient 개체입니다.

반환 형식

DataLakeLeaseClient

close

이 방법은 클라이언트가 연 소켓을 닫는 것입니다. 컨텍스트 관리자와 함께 사용할 때 사용할 필요가 없습니다.

close() -> None

create_directory

새 디렉터리를 만듭니다.

create_directory(metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, str | datetime]

매개 변수

metadata
dict(str, str)
필수

파일 내에서 메타데이터로 연결된 이름-값 쌍입니다.

content_settings
ContentSettings

경로 속성을 설정하는 데 사용되는 ContentSettings 개체입니다.

lease
DataLakeLeaseClient 또는 str

파일에 활성 임대가 있는 경우 필요합니다. 값은 DataLakeLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

umask
str

선택 사항이며 계층 구조 네임스페이스가 계정에 대해 사용하도록 설정된 경우에만 유효합니다. 파일 또는 디렉터리를 만들고 부모 폴더에 기본 ACL이 없는 경우 umask는 만들 파일 또는 디렉터리의 권한을 제한합니다. 결과 권한은 p & ^u에 의해 부여됩니다. 여기서 p는 사용 권한이며 umask입니다. 예를 들어 p가 0777이고 0057인 경우 결과 권한은 0720입니다. 기본 권한은 디렉터리의 경우 0777이고 파일의 경우 0666입니다. 기본 umask는 0027입니다. umask는 4자리 8진수 표기법(예: 0766)으로 지정해야 합니다.

owner
str

파일 또는 디렉터리의 소유자입니다.

group
str

파일 또는 디렉터리의 소유 그룹입니다.

acl
str

파일 및 디렉터리에 대한 POSIX 액세스 제어 권한을 설정합니다. 값은 액세스 제어 항목의 쉼표로 구분된 목록입니다. ACE(각 액세스 제어 항목)는 scope, 형식, 사용자 또는 그룹 식별자 및 "[scope:][type]:[id]:[permissions]" 형식의 권한으로 구성됩니다.

lease_id
str

GUID 문자열 형식의 제안된 임대 ID입니다. 제안된 임대 ID가 올바른 형식이 아닌 경우 DataLake 서비스는 400(잘못된 요청)을 반환합니다.

lease_duration
int

임대 기간(초)을 지정하거나 만료되지 않는 임대의 경우 -1을 지정합니다. 가능한 유한 임대 기간은 15~60초 사이입니다. 갱신 또는 변경을 사용하여 임대 기간을 변경할 수 없습니다.

permissions
str

선택 사항이며 계층 구조 네임스페이스가 계정에 대해 사용하도록 설정된 경우에만 유효합니다. 파일 소유자, 파일 소유 그룹 등에 대한 POSIX 액세스 권한을 설정합니다. 각 클래스에는 읽기, 쓰기 또는 실행 권한이 부여될 수 있습니다. 고정 비트도 지원됩니다. 기호(rwxrw-rw-) 및 4자리 8진수 표기법(예: 0766)이 모두 지원됩니다.

if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

cpk
CustomerProvidedEncryptionKey

지정된 키를 사용하여 서비스 쪽의 데이터를 암호화합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

응답 헤더의 사전입니다.

반환 형식

Dict[str, Union[str, datetime]]

예제

디렉터리를 만듭니다.


   directory_client.create_directory()

create_file

새 파일을 만들고 상호 작용할 파일 클라이언트를 반환합니다.

create_file(file: FileProperties | str, **kwargs) -> DataLakeFileClient

매개 변수

file
str 또는 FileProperties
필수

상호 작용할 파일입니다. 파일의 이름 또는 FileProperties의 instance 수 있습니다.

content_settings
ContentSettings

경로 속성을 설정하는 데 사용되는 ContentSettings 개체입니다.

metadata

파일 내에서 메타데이터로 연결된 이름-값 쌍입니다.

lease
DataLakeLeaseClient 또는 str

파일에 활성 임대가 있는 경우 필요합니다. 값은 DataLakeLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

umask
str

선택 사항이며 계층 구조 네임스페이스가 계정에 대해 사용하도록 설정된 경우에만 유효합니다. 파일 또는 디렉터리를 만들고 부모 폴더에 기본 ACL이 없는 경우 umask는 만들 파일 또는 디렉터리의 권한을 제한합니다. 결과 권한은 p & ^u에 의해 부여됩니다. 여기서 p는 사용 권한이며 umask입니다. 예를 들어 p가 0777이고 0057인 경우 결과 권한은 0720입니다. 기본 권한은 디렉터리의 경우 0777이고 파일의 경우 0666입니다. 기본 umask는 0027입니다. umask는 4자리 8진수 표기법(예: 0766)으로 지정해야 합니다.

owner
str

파일 또는 디렉터리의 소유자입니다.

group
str

파일 또는 디렉터리의 소유 그룹입니다.

acl
str

파일 및 디렉터리에 대한 POSIX 액세스 제어 권한을 설정합니다. 값은 액세스 제어 항목의 쉼표로 구분된 목록입니다. ACE(각 액세스 제어 항목)는 scope, 형식, 사용자 또는 그룹 식별자 및 "[scope:][type]:[id]:[permissions]" 형식의 권한으로 구성됩니다.

lease_id
str

GUID 문자열 형식의 제안된 임대 ID입니다. 제안된 임대 ID가 올바른 형식이 아닌 경우 DataLake 서비스는 400(잘못된 요청)을 반환합니다.

lease_duration
int

임대 기간(초)을 지정하거나 만료되지 않는 임대의 경우 -1을 지정합니다. 가능한 유한 임대 기간은 15~60초 사이입니다. 갱신 또는 변경을 사용하여 임대 기간을 변경할 수 없습니다.

expires_on
datetime 또는 int

파일을 만료로 설정하는 시간입니다. expires_on 유형이 int인 경우 만료 시간은 생성 시간으로부터 경과된 밀리초 수로 설정됩니다. expires_on 유형이 datetime인 경우 만료 시간은 제공된 시간으로 절대로 설정됩니다. 표준 시간대 정보가 제공되지 않으면 UTC로 해석됩니다.

permissions
str

선택 사항이며 계층 구조 네임스페이스가 계정에 대해 사용하도록 설정된 경우에만 유효합니다. 파일 소유자, 파일 소유 그룹 등에 대한 POSIX 액세스 권한을 설정합니다. 각 클래스에는 읽기, 쓰기 또는 실행 권한이 부여될 수 있습니다. 고정 비트도 지원됩니다. 기호(rwxrw-rw-) 및 4자리 8진수 표기법(예: 0766)이 모두 지원됩니다.

if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

cpk
CustomerProvidedEncryptionKey

지정된 키를 사용하여 서비스 쪽의 데이터를 암호화합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

DataLakeFileClient

create_sub_directory

하위 디렉터리를 만들고 상호 작용할 하위 디렉터리 클라이언트를 반환합니다.

create_sub_directory(sub_directory: DirectoryProperties | str, metadata: Dict[str, str] | None = None, **kwargs) -> DataLakeDirectoryClient

매개 변수

sub_directory
str 또는 DirectoryProperties
필수

상호 작용할 디렉터리입니다. 디렉터리의 이름 또는 DirectoryProperties의 instance 수 있습니다.

metadata
dict(str, str)
필수

파일 내에서 메타데이터로 연결된 이름-값 쌍입니다.

content_settings
ContentSettings

경로 속성을 설정하는 데 사용되는 ContentSettings 개체입니다.

lease
DataLakeLeaseClient 또는 str

파일에 활성 임대가 있는 경우 필요합니다. 값은 DataLakeLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

umask
str

선택 사항이며 계층 구조 네임스페이스가 계정에 대해 사용하도록 설정된 경우에만 유효합니다. 파일 또는 디렉터리를 만들고 부모 폴더에 기본 ACL이 없는 경우 umask는 만들 파일 또는 디렉터리의 권한을 제한합니다. 결과 권한은 p & ^u에 의해 부여됩니다. 여기서 p는 사용 권한이며 umask입니다. 예를 들어 p가 0777이고 0057인 경우 결과 권한은 0720입니다. 기본 권한은 디렉터리의 경우 0777이고 파일의 경우 0666입니다. 기본 umask는 0027입니다. umask는 4자리 8진수 표기법(예: 0766)으로 지정해야 합니다.

owner
str

파일 또는 디렉터리의 소유자입니다.

group
str

파일 또는 디렉터리의 소유 그룹입니다.

acl
str

파일 및 디렉터리에 대한 POSIX 액세스 제어 권한을 설정합니다. 값은 액세스 제어 항목의 쉼표로 구분된 목록입니다. ACE(각 액세스 제어 항목)는 scope, 형식, 사용자 또는 그룹 식별자 및 "[scope:][type]:[id]:[permissions]" 형식의 권한으로 구성됩니다.

lease_id
str

GUID 문자열 형식의 제안된 임대 ID입니다. 제안된 임대 ID가 올바른 형식이 아닌 경우 DataLake 서비스는 400(잘못된 요청)을 반환합니다.

lease_duration
int

임대 기간(초)을 지정하거나 만료되지 않는 임대의 경우 -1을 지정합니다. 가능한 유한 임대 기간은 15~60초 사이입니다. 갱신 또는 변경을 사용하여 임대 기간을 변경할 수 없습니다.

permissions
str

선택 사항이며 계층 구조 네임스페이스가 계정에 대해 사용하도록 설정된 경우에만 유효합니다. 파일 소유자, 파일 소유 그룹 등에 대한 POSIX 액세스 권한을 설정합니다. 각 클래스에는 읽기, 쓰기 또는 실행 권한이 부여될 수 있습니다. 고정 비트도 지원됩니다. 기호(rwxrw-rw-) 및 4자리 8진수 표기법(예: 0766)이 모두 지원됩니다.

if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

cpk
CustomerProvidedEncryptionKey

지정된 키를 사용하여 서비스 쪽의 데이터를 암호화합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

하위 디렉터리에 대한 DataLakeDirectoryClient입니다.

delete_directory

삭제할 지정된 디렉터리를 표시합니다.

delete_directory(**kwargs) -> None

매개 변수

lease
DataLakeLeaseClient 또는 str

파일에 활성 임대가 있는 경우 필요합니다. 값은 LeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

없음

예제

디렉터리를 삭제합니다.


   new_directory.delete_directory()

delete_sub_directory

삭제할 지정된 하위 디렉터리를 표시합니다.

delete_sub_directory(sub_directory: DirectoryProperties | str, **kwargs) -> DataLakeDirectoryClient

매개 변수

sub_directory
str 또는 DirectoryProperties
필수

상호 작용할 디렉터리입니다. 디렉터리의 이름 또는 DirectoryProperties의 instance 수 있습니다.

lease
DataLakeLeaseClient 또는 str

파일에 활성 임대가 있는 경우 필요합니다. 값은 LeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

하위 디렉터리에 대한 DataLakeDirectoryClient

exists

디렉터리가 있으면 True를 반환하고, 그렇지 않으면 False를 반환합니다.

exists(**kwargs: Any) -> bool

매개 변수

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

디렉터리가 있으면 True, 그렇지 않으면 False입니다.

반환 형식

bool

from_connection_string

연결 문자열에서 DataLakeDirectoryClient를 만듭니다.

from_connection_string(conn_str: str, file_system_name: str, directory_name: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any) -> Self

매개 변수

conn_str
str
필수

Azure Storage 계정에 대한 연결 문자열입니다.

file_system_name
str
필수

상호 작용할 파일 시스템의 이름입니다.

credential
기본값: None

인증할 자격 증명입니다. 계정 URL에 이미 SAS 토큰이 있는 경우 선택 사항입니다. 값은 SAS 토큰 문자열, azure.core.credentials에서 AzureSasCredential 또는 AzureNamedKeyCredential의 instance, 계정 공유 액세스 키 또는 azure.identity에서 TokenCredentials 클래스의 instance 수 있습니다. 리소스 URI에 이미 SAS 토큰이 포함된 경우 명시적 자격 증명을 위해 무시됩니다.

  • 충돌하는 SAS 토큰이 ValueError를 발생시키는 AzureSasCredential의 경우를 제외하고. AzureNamedKeyCredential의 instance 사용하는 경우 "name"은 스토리지 계정 이름이고 "키"는 스토리지 계정 키여야 합니다.
directory_name
str
필수

상호 작용할 디렉터리의 이름입니다. 디렉터리가 파일 시스템에 있습니다.

credential
필수

인증할 자격 증명입니다. 계정 URL에 이미 SAS 토큰이 있거나 연결 문자열에 공유 액세스 키 값이 이미 있는 경우 선택 사항입니다. 값은 SAS 토큰 문자열, azure.core.credentials에서 AzureSasCredential 또는 AzureNamedKeyCredential의 instance, 계정 공유 액세스 키 또는 azure.identity에서 TokenCredentials 클래스의 instance 수 있습니다. 여기에 제공된 자격 증명이 연결 문자열의 자격 증명보다 우선합니다. AzureNamedKeyCredential의 instance 사용하는 경우 "name"은 스토리지 계정 이름이고 "키"는 스토리지 계정 키여야 합니다.

반환

DataLakeDirectoryClient

반환 형식

DataLakeDirectoryClient

get_access_control 

get_access_control(upn: bool | None = None, **kwargs) -> Dict[str, Any]

매개 변수

upn
bool
필수

(선택 사항) 계정에 대해 계층 구조 네임스페이스를 사용하는 경우에만 유효합니다. "true"이면 x-ms-owner, x-ms-group 및 x-ms-acl 응답 헤더에 반환된 사용자 ID 값이 Azure Active Directory 개체 ID에서 사용자 계정 이름으로 변환됩니다. "false"이면 값이 Azure Active Directory 개체 ID로 반환됩니다. 기본값은 False입니다. 그룹 및 애플리케이션 개체 ID는 고유한 식별 이름이 없으므로 번역되지 않습니다.

lease
DataLakeLeaseClient 또는 str

파일/디렉터리에 활성 임대가 있는 경우 필요합니다. 값은 LeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

response dict

응답 받아쓰기.

get_directory_properties

디렉터리에 대한 모든 사용자 정의 메타데이터, 표준 HTTP 속성 및 시스템 속성을 반환합니다. 디렉터리의 콘텐츠를 반환하지 않습니다.

get_directory_properties(**kwargs: Any) -> DirectoryProperties

매개 변수

lease
DataLakeLeaseClient 또는 str

디렉터리 또는 파일에 활성 임대가 있는 경우 필수입니다. 값은 DataLakeLeaseClient 개체 또는 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

cpk
CustomerProvidedEncryptionKey

지정된 키를 사용하여 서비스 쪽의 데이터를 암호 해독합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 고객이 제공한 키를 사용하여 디렉터리를 만든 경우 필요합니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환 형식

DirectoryProperties

예제

파일/디렉터리에 대한 속성을 가져옵니다.


   props = new_directory.get_directory_properties()

get_file_client

지정된 파일과 상호 작용할 클라이언트를 가져옵니다.

파일이 아직 필요하지 않습니다.

get_file_client(file: FileProperties | str) -> DataLakeFileClient

매개 변수

file
str 또는 FileProperties
필수

상호 작용할 파일입니다. 파일의 이름이거나 FileProperties의 instance 수 있습니다. 예를 들어 디렉터리/하위 디렉터리/파일

반환

DataLakeFileClient입니다.

반환 형식

DataLakeFileClient

get_sub_directory_client

현재 디렉터리의 지정된 하위 디렉터리와 상호 작용할 클라이언트를 가져옵니다.

하위 디렉터리가 아직 필요하지 않습니다.

get_sub_directory_client(sub_directory: DirectoryProperties | str) -> DataLakeDirectoryClient

매개 변수

sub_directory
str 또는 DirectoryProperties
필수

상호 작용할 디렉터리입니다. 디렉터리의 이름 또는 DirectoryProperties의 instance 수 있습니다.

반환

DataLakeDirectoryClient입니다.

반환 형식

DataLakeDirectoryClient

remove_access_control_recursive

경로 및 하위 경로의 Access Control 제거합니다.

remove_access_control_recursive(acl: str, **kwargs: Any) -> AccessControlChangeResult

매개 변수

acl
str
필수

파일 및 디렉터리에 대한 POSIX 액세스 제어 권한을 제거합니다. 값은 쉼표로 구분된 액세스 제어 항목 목록입니다. ACE(각 액세스 제어 항목)는 "[scope:][type]:[id]" 형식의 scope, 형식 및 사용자 또는 그룹 식별자로 구성됩니다.

progress_hook
<xref:func>(AccessControlChanges)

호출자가 작업의 진행률을 추적하고 Access Control 변경하지 못한 경로를 수집할 수 있는 콜백입니다.

continuation_token
str

이전에 중지된 작업을 다시 시작하는 데 사용할 수 있는 선택적 연속 토큰입니다.

batch_size
int

(선택 사항) 데이터 집합 크기가 일괄 처리 크기를 초과하면 작업이 여러 요청으로 분할되어 진행률을 추적할 수 있습니다. 일괄 처리 크기는 1에서 2000 사이여야 합니다. 지정되지 않은 경우 기본값은 2000입니다.

max_batches
int

(선택 사항) 단일 변경 Access Control 작업을 실행할 수 있는 일괄 처리의 최대 수를 정의합니다. 모든 하위 경로가 처리되기 전에 최대값에 도달하면 연속 토큰을 사용하여 작업을 다시 시작할 수 있습니다. 빈 값은 언바운드의 최대 일괄 처리 수와 작업이 끝날 때까지 계속됨을 나타냅니다.

continue_on_failure
bool

False로 설정하면 사용자 오류(4XX)가 발생할 때 작업이 빠르게 종료됩니다. True이면 작업에서 사용자 오류를 무시하고 디렉터리의 다른 하위 엔터티에 대한 작업을 진행합니다. 연속 토큰은 사용자 오류 발생 시 continue_on_failure True인 경우에만 반환됩니다. 설정하지 않으면 기본값이 False입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

작업이 조기에 종료된 경우의 연속 토큰뿐만 아니라 성공 및 실패 수를 포함한 재귀 작업에 대한 요약입니다.

반환 형식

AccessControlChangeResult

예외

AzureError

토큰을 사용할 수 있는 경우 사용자는 AzureError의 continuation_token 필드를 사용하여 작업을 다시 시작할 수 있습니다.

rename_directory

원본 디렉터리의 이름을 바꿉니다.

rename_directory(new_name: str, **kwargs: Any) -> DataLakeDirectoryClient

매개 변수

new_name
str
필수

사용자가 이름을 바꾸려는 새 디렉터리 이름입니다. 값의 형식은 "{filesystem}/{directory}/{subdirectory}"여야 합니다.

source_lease
DataLakeLeaseClient 또는 str

원본 경로에 대한 임대 ID입니다. 지정된 경우 원본 경로에 활성 임대가 있어야 하며 임대 ID가 일치해야 합니다.

lease
DataLakeLeaseClient 또는 str

파일/디렉터리에 활성 임대가 있는 경우 필요합니다. 값은 LeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

source_if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

source_if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

source_etag
str

원본 ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

source_match_condition
MatchConditions

etag에 사용할 원본 일치 조건입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

DataLakeDirectoryClient

예제

원본 디렉터리의 이름을 바꿉니다.


   new_dir_name = "testdir2"
   print("Renaming the directory named '{}' to '{}'.".format(dir_name, new_dir_name))
   new_directory = directory_client\
       .rename_directory(new_name=directory_client.file_system_name + '/' + new_dir_name)

set_access_control

경로에 대한 소유자, 그룹, 권한 또는 액세스 제어 목록을 설정합니다.

set_access_control(owner: str | None = None, group: str | None = None, permissions: str | None = None, acl: str | None = None, **kwargs) -> Dict[str, str | datetime]

매개 변수

owner
str
필수

(선택 사항) 파일 또는 디렉터리의 소유자입니다.

group
str
필수

(선택 사항) 파일 또는 디렉터리의 소유 그룹입니다.

permissions
str
필수

선택 사항이며 계정에 대해 계층 구조 네임스페이스를 사용하는 경우에만 유효합니다. 파일 소유자, 파일 소유 그룹 등에 대한 POSIX 액세스 권한을 설정합니다. 각 클래스에는 읽기, 쓰기 또는 실행 권한이 부여될 수 있습니다. 고정 비트도 지원됩니다. 기호(rwxrw-rw-) 및 4자리 8진수 표기법(예: 0766)이 모두 지원됩니다. 권한 및 acl은 상호 배타적입니다.

acl
str
필수

파일 및 디렉터리에 대한 POSIX 액세스 제어 권한을 설정합니다. 값은 쉼표로 구분된 액세스 제어 항목 목록입니다. ACE(각 액세스 제어 항목)는 "[scope:][type]:[id]:[permissions]" 형식의 scope, 형식, 사용자 또는 그룹 식별자 및 권한으로 구성됩니다. 권한 및 acl은 상호 배타적입니다.

lease
DataLakeLeaseClient 또는 str

파일/디렉터리에 활성 임대가 있는 경우 필요합니다. 값은 LeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

response dict

응답 받아쓰기(Etag 및 마지막으로 수정됨).

set_access_control_recursive

경로 및 하위 경로의 Access Control 설정합니다.

set_access_control_recursive(acl: str, **kwargs: Any) -> AccessControlChangeResult

매개 변수

acl
str
필수

파일 및 디렉터리에 대한 POSIX 액세스 제어 권한을 설정합니다. 값은 쉼표로 구분된 액세스 제어 항목 목록입니다. ACE(각 액세스 제어 항목)는 "[scope:][type]:[id]:[permissions]" 형식의 scope, 형식, 사용자 또는 그룹 식별자 및 권한으로 구성됩니다.

progress_hook
<xref:func>(AccessControlChanges)

호출자가 작업의 진행률을 추적하고 Access Control 변경하지 못한 경로를 수집할 수 있는 콜백입니다.

continuation_token
str

이전에 중지된 작업을 다시 시작하는 데 사용할 수 있는 선택적 연속 토큰입니다.

batch_size
int

(선택 사항) 데이터 집합 크기가 일괄 처리 크기를 초과하면 작업이 여러 요청으로 분할되어 진행률을 추적할 수 있습니다. 일괄 처리 크기는 1에서 2000 사이여야 합니다. 지정되지 않은 경우 기본값은 2000입니다.

max_batches
int

(선택 사항) 단일 변경 Access Control 작업을 실행할 수 있는 일괄 처리의 최대 수를 정의합니다. 모든 하위 경로가 처리되기 전에 최대값에 도달하면 연속 토큰을 사용하여 작업을 다시 시작할 수 있습니다. 빈 값은 언바운드의 최대 일괄 처리 수와 작업이 끝날 때까지 계속됨을 나타냅니다.

continue_on_failure
bool

False로 설정하면 사용자 오류(4XX)가 발생할 때 작업이 빠르게 종료됩니다. True이면 작업에서 사용자 오류를 무시하고 디렉터리의 다른 하위 엔터티에 대한 작업을 진행합니다. 연속 토큰은 사용자 오류 발생 시 continue_on_failure True인 경우에만 반환됩니다. 설정하지 않으면 기본값이 False입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

작업이 조기에 종료된 경우의 연속 토큰뿐만 아니라 성공 및 실패 수를 포함한 재귀 작업에 대한 요약입니다.

반환 형식

AccessControlChangeResult

예외

AzureError

토큰을 사용할 수 있는 경우 사용자는 AzureError의 continuation_token 필드를 사용하여 작업을 다시 시작할 수 있습니다.

set_http_headers

파일 또는 디렉터리의 시스템 속성을 설정합니다.

content_settings 대해 하나의 속성이 설정된 경우 모든 속성이 재정의됩니다.

set_http_headers(content_settings: ContentSettings | None = None, **kwargs) -> Dict[str, Any]

매개 변수

content_settings
ContentSettings
필수

파일/디렉터리 속성을 설정하는 데 사용되는 ContentSettings 개체입니다.

lease
DataLakeLeaseClient 또는 str

지정된 경우 set_file_system_metadata 파일 시스템의 임대가 활성 상태이고 이 ID와 일치하는 경우에만 성공합니다.

if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

file/directory-updated 속성 dict(Etag 및 마지막으로 수정됨)

반환 형식

Dict[str, Any]

set_metadata

지정된 파일 시스템에 대해 하나 이상의 사용자 정의 이름-값 쌍을 설정합니다. 이 작업에 대한 각 호출은 파일 시스템에 연결된 모든 기존 메타데이터를 대체합니다. 파일 시스템에서 모든 메타데이터를 제거하려면 메타데이터 받아쓰기 없이 이 작업을 호출합니다.

set_metadata(metadata: Dict[str, str], **kwargs) -> Dict[str, str | datetime]

매개 변수

metadata
Dict[str, str]
필수

파일 시스템과 메타데이터로 연결할 이름-값 쌍을 포함하는 받아쓰기입니다. 예: {'category':'test'}

lease
DataLakeLeaseClient 또는 str

지정된 경우 set_file_system_metadata 파일 시스템의 임대가 활성 상태이고 이 ID와 일치하는 경우에만 성공합니다.

if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

cpk
CustomerProvidedEncryptionKey

지정된 키를 사용하여 서비스 쪽의 데이터를 암호화합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

파일 시스템 업데이트 속성 dict(Etag 및 마지막으로 수정됨).

update_access_control_recursive

경로 및 하위 경로의 Access Control 수정합니다.

update_access_control_recursive(acl: str, **kwargs: Any) -> AccessControlChangeResult

매개 변수

acl
str
필수

파일 및 디렉터리에 대한 POSIX 액세스 제어 권한을 수정합니다. 값은 쉼표로 구분된 액세스 제어 항목 목록입니다. ACE(각 액세스 제어 항목)는 "[scope:][type]:[id]:[permissions]" 형식의 scope, 형식, 사용자 또는 그룹 식별자 및 권한으로 구성됩니다.

progress_hook
<xref:func>(AccessControlChanges)

호출자가 작업의 진행률을 추적하고 Access Control 변경하지 못한 경로를 수집할 수 있는 콜백입니다.

continuation_token
str

이전에 중지된 작업을 다시 시작하는 데 사용할 수 있는 선택적 연속 토큰입니다.

batch_size
int

(선택 사항) 데이터 집합 크기가 일괄 처리 크기를 초과하면 작업이 여러 요청으로 분할되어 진행률을 추적할 수 있습니다. 일괄 처리 크기는 1에서 2000 사이여야 합니다. 지정되지 않은 경우 기본값은 2000입니다.

max_batches
int

(선택 사항) 단일 변경 Access Control 작업을 실행할 수 있는 일괄 처리의 최대 수를 정의합니다. 모든 하위 경로가 처리되기 전에 최대값에 도달하면 연속 토큰을 사용하여 작업을 다시 시작할 수 있습니다. 빈 값은 언바운드의 최대 일괄 처리 수와 작업이 끝날 때까지 계속됨을 나타냅니다.

continue_on_failure
bool

False로 설정하면 사용자 오류(4XX)가 발생할 때 작업이 빠르게 종료됩니다. True이면 작업에서 사용자 오류를 무시하고 디렉터리의 다른 하위 엔터티에 대한 작업을 진행합니다. 연속 토큰은 사용자 오류 발생 시 continue_on_failure True인 경우에만 반환됩니다. 설정하지 않으면 기본값이 False입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

작업이 조기에 종료된 경우의 연속 토큰뿐만 아니라 성공 및 실패 수를 포함한 재귀 작업에 대한 요약입니다.

반환 형식

AccessControlChangeResult

예외

AzureError

토큰을 사용할 수 있는 경우 사용자는 AzureError의 continuation_token 필드를 사용하여 작업을 다시 시작할 수 있습니다.

특성

api_version

요청에 사용되는 Storage API의 버전입니다.

location_mode

클라이언트가 현재 사용하고 있는 위치 모드입니다.

기본적으로 "기본"입니다. 옵션에는 "기본" 및 "보조"가 포함됩니다.

primary_endpoint

전체 기본 엔드포인트 URL입니다.

primary_hostname

기본 엔드포인트의 호스트 이름입니다.

secondary_endpoint

구성된 경우 전체 보조 엔드포인트 URL입니다.

사용할 수 없는 경우 ValueError가 발생합니다. 보조 호스트 이름을 명시적으로 지정하려면 인스턴스화에 선택적 secondary_hostname 키워드(keyword) 인수를 사용합니다.

예외

ValueError

secondary_hostname

보조 엔드포인트의 호스트 이름입니다.

사용할 수 없는 경우 없음이 됩니다. 보조 호스트 이름을 명시적으로 지정하려면 인스턴스화에 선택적 secondary_hostname 키워드(keyword) 인수를 사용합니다.

url

사용되는 경우 SAS 토큰을 포함하여 이 엔터티에 대한 전체 엔드포인트 URL입니다.

이는 기본 엔드포인트이거나 현재 location_mode에 따라 보조 엔드포인트일 수 있습니다. :returns: 사용되는 경우 SAS 토큰을 포함하여 이 엔터티에 대한 전체 엔드포인트 URL입니다. :rtype: str