azure.storage.blob.aio.BlobLeaseClient class

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

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

async 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로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

timeout: int

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

반환 형식

None

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

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

async 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로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

timeout: int

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

반환

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

반환 형식

int

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

async 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로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

timeout: int

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

반환

없음

임대를 해제합니다.

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

async 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로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

timeout: int

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

반환

없음

임대를 갱신합니다.

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

async 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 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

없음

다음을 통해 공유

BlobLeaseClient 클래스

생성자

매개 변수

변수

메서드

acquire

매개 변수

반환 형식

break_lease

매개 변수

반환

반환 형식

change

매개 변수

반환

release

매개 변수

반환

renew

매개 변수

반환

추가 리소스

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