BlobLeaseClient 클래스

새 BlobLeaseClient를 만듭니다.

이 클라이언트는 BlobClient 또는 ContainerClient에서 임대 작업을 제공합니다.

상속

builtins.object

BlobLeaseClient

생성자

BlobLeaseClient(client: BlobClient | ContainerClient, lease_id: str | None = None)

매개 변수

client

BlobClient 또는 ContainerClient

필수

임대할 Blob 또는 컨테이너의 클라이언트입니다.

lease_id

str

기본값: None

기존 임대의 임대 ID를 나타내는 문자열입니다. 새 임대를 획득하거나 임대를 중단하기 위해 이 값을 지정할 필요가 없습니다.

변수

id

str

현재 유지 관리 중인 임대의 ID입니다. 임대 를 아직 취득하지 않은 경우 None이 됩니다.

etag

str

현재 유지 관리 중인 임대의 ETag입니다. 임대 를 아직 획득하거나 수정하지 않은 경우 None이 됩니다.

last_modified

datetime

현재 유지 관리 중인 임대의 마지막으로 수정된 타임스탬프입니다. 임대 를 아직 획득하거나 수정하지 않은 경우 None이 됩니다.

메서드

acquire	새로운 임대를 요청합니다. 컨테이너에 활성 임대가 없으면, Blob 서비스가 컨테이너에 대한 임대를 만들고 새로운 임대 ID를 반환합니다.
break_lease	컨테이너 또는 Blob에 활성 임대가 있는 경우 임대를 중단합니다. 임대가 중단되면 갱신할 수 없습니다. 권한이 부여된 요청으로 임대를 중단할 수 있으며, 요청 시 일치하는 임대 ID를 지정할 필요가 없습니다. 임대가 중단되면 임대 중단 기간이 경과할 수 있으며, 이 기간 동안 컨테이너 또는 Blob에서 중단 및 해제를 제외한 임대 작업을 수행할 수 없습니다. 임대가 성공적으로 중단되면 새로운 임대를 획득하기 위해 기다려야 하는 기간(초)이 응답에 표시됩니다.
change	활성 임대의 임대 ID를 변경합니다.
release	임대를 해제합니다. 지정된 클라이언트 임대 ID가 컨테이너 또는 Blob과 연결된 것과 일치하는 경우 임대가 해제될 수 있습니다. 임대를 해제하면 릴리스가 완료되는 즉시 다른 클라이언트가 컨테이너 또는 Blob에 대한 임대를 즉시 획득할 수 있습니다.
renew	임대를 갱신합니다. 임대 클라이언트에 지정된 임대 ID가 컨테이너 또는 Blob과 연결된 임대 ID와 일치하는 경우 임대를 갱신할 수 있습니다. 해당 임대 만료 이후 컨테이너 또는 Blob이 다시 임대되지 않은 한 임대가 만료된 경우에도 임대를 갱신할 수 있습니다. 임대를 갱신하면 임대 기간 시간이 재설정됩니다.

acquire

새로운 임대를 요청합니다.

컨테이너에 활성 임대가 없으면, Blob 서비스가 컨테이너에 대한 임대를 만들고 새로운 임대 ID를 반환합니다.

acquire(lease_duration: int = -1, **kwargs: Any) -> None

매개 변수

lease_duration

int

필수

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

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에 사용할 일치 조건입니다.

if_tags_match_condition

str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능입니다.

timeout

int

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

반환 형식

None

break_lease

컨테이너 또는 Blob에 활성 임대가 있는 경우 임대를 중단합니다.

임대가 중단되면 갱신할 수 없습니다. 권한이 부여된 요청으로 임대를 중단할 수 있으며, 요청 시 일치하는 임대 ID를 지정할 필요가 없습니다. 임대가 중단되면 임대 중단 기간이 경과할 수 있으며, 이 기간 동안 컨테이너 또는 Blob에서 중단 및 해제를 제외한 임대 작업을 수행할 수 없습니다. 임대가 성공적으로 중단되면 새로운 임대를 획득하기 위해 기다려야 하는 기간(초)이 응답에 표시됩니다.

break_lease(lease_break_period: int | None = None, **kwargs: Any) -> int

매개 변수

lease_break_period

int

필수

이는 임대가 손상되기 전에 0초에서 60초 사이에 계속되어야 하는 제안된 시간(초)입니다. 이 중단 기간은 남은 임대 기간보다 짧은 경우에만 사용됩니다. 남은 임대 기간이 더 길면 이 기간이 사용됩니다. 중단 기간이 만료되기 전까지는 새로운 임대를 사용할 수 없지만 중단 기간보다 오랫동안 임대가 유지될 수 있습니다. 이 헤더가 중단 작업과 함께 표시되지 않으면 남은 임대 기간이 경과한 후 고정 기간 임대가 중단되고 무한 임대가 즉시 중단됩니다.

if_modified_since

datetime

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

if_unmodified_since

datetime

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

if_tags_match_condition

str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능입니다.

timeout

int

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

반환

임대 기간에 남은 대략적인 시간(초)입니다.

반환 형식

int

change

활성 임대의 임대 ID를 변경합니다.

change(proposed_lease_id: str, **kwargs: Any) -> None

매개 변수

proposed_lease_id

str

필수

GUID 문자열 형식의 제안된 임대 ID입니다. 제안된 임대 ID가 올바른 형식이 아닌 경우 Blob 서비스는 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에 사용할 일치 조건입니다.

if_tags_match_condition

str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능입니다.

timeout

int

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

반환

없음

release

임대를 해제합니다.

지정된 클라이언트 임대 ID가 컨테이너 또는 Blob과 연결된 것과 일치하는 경우 임대가 해제될 수 있습니다. 임대를 해제하면 릴리스가 완료되는 즉시 다른 클라이언트가 컨테이너 또는 Blob에 대한 임대를 즉시 획득할 수 있습니다.

release(**kwargs: Any) -> None

매개 변수

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에 사용할 일치 조건입니다.

if_tags_match_condition

str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

timeout

int

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

반환

없음

renew

임대를 갱신합니다.

임대 클라이언트에 지정된 임대 ID가 컨테이너 또는 Blob과 연결된 임대 ID와 일치하는 경우 임대를 갱신할 수 있습니다. 해당 임대 만료 이후 컨테이너 또는 Blob이 다시 임대되지 않은 한 임대가 만료된 경우에도 임대를 갱신할 수 있습니다. 임대를 갱신하면 임대 기간 시간이 재설정됩니다.

renew(**kwargs: Any) -> None

매개 변수

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에 사용할 일치 조건입니다.

if_tags_match_condition

str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

timeout

int

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

반환

없음