다음을 통해 공유

ShareLeaseClient 클래스

  • 참조

새 ShareLeaseClient를 만듭니다.

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

상속
builtins.object
ShareLeaseClient

생성자

ShareLeaseClient(client: ShareFileClient | ShareClient, lease_id: str | None = None)

매개 변수

client
ShareFileClient 또는 ShareClient
필수

임대할 파일 또는 공유의 클라이언트입니다.

lease_id
str
기본값: None

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

변수

id
str

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

etag
str

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

last_modified
datetime

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

메서드

acquire

새로운 임대를 요청합니다. 이 작업은 쓰기 및 삭제 작업을 위해 파일 또는 공유에 대한 잠금을 설정하고 관리합니다. 파일 또는 공유에 활성 임대가 없는 경우 파일 또는 공유 서비스는 파일 또는 공유에 임대를 만듭니다. 파일에 활성 임대가 있는 경우 활성 임대 ID를 사용하여 새 임대만 요청할 수 있습니다.

파일 또는 공유에 활성 임대가 없는 경우 파일 또는 공유 서비스는 파일에 임대를 만들고 새 임대 ID를 반환합니다.
break_lease

파일 또는 공유에 활성 임대가 있는 경우 강제로 임대를 중단합니다. 권한이 부여된 요청으로 임대를 중단할 수 있으며, 요청 시 일치하는 임대 ID를 지정할 필요가 없습니다. 무한 임대는 즉시 중단됩니다.

임대가 끊어지면 변경할 수 없습니다. 권한이 부여된 요청으로 임대를 중단할 수 있으며, 요청 시 일치하는 임대 ID를 지정할 필요가 없습니다. 임대가 성공적으로 중단되면 새로운 임대를 획득하기 위해 기다려야 하는 기간(초)이 응답에 표시됩니다.
change

활성 임대의 임대 ID를 변경합니다. 변경 내용에는 x-ms-lease-id의 현재 임대 ID와 x-ms-proposed-lease-id의 새 임대 ID가 포함되어야 합니다.
release

임대를 해제합니다. 요청에 지정된 임대 ID가 공유 또는 파일과 연결된 임대 ID와 일치하는 경우 임대가 해제될 수 있습니다. 임대를 해제하면 릴리스가 완료되는 즉시 다른 클라이언트가 공유 또는 파일에 대한 임대를 즉시 획득할 수 있습니다.
renew

공유 임대를 갱신합니다.

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

버전 12.6.0의 새로운 기능

acquire

새로운 임대를 요청합니다. 이 작업은 쓰기 및 삭제 작업을 위해 파일 또는 공유에 대한 잠금을 설정하고 관리합니다. 파일 또는 공유에 활성 임대가 없는 경우 파일 또는 공유 서비스는 파일 또는 공유에 임대를 만듭니다. 파일에 활성 임대가 있는 경우 활성 임대 ID를 사용하여 새 임대만 요청할 수 있습니다.

파일 또는 공유에 활성 임대가 없는 경우 파일 또는 공유 서비스는 파일에 임대를 만들고 새 임대 ID를 반환합니다.

acquire(**kwargs: Any) -> None

매개 변수

lease_duration
int

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

timeout
int

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

반환 형식

None

break_lease

파일 또는 공유에 활성 임대가 있는 경우 강제로 임대를 중단합니다. 권한이 부여된 요청으로 임대를 중단할 수 있으며, 요청 시 일치하는 임대 ID를 지정할 필요가 없습니다. 무한 임대는 즉시 중단됩니다.

임대가 끊어지면 변경할 수 없습니다. 권한이 부여된 요청으로 임대를 중단할 수 있으며, 요청 시 일치하는 임대 ID를 지정할 필요가 없습니다. 임대가 성공적으로 중단되면 새로운 임대를 획득하기 위해 기다려야 하는 기간(초)이 응답에 표시됩니다.

break_lease(**kwargs: Any) -> int

매개 변수

lease_break_period
int

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

버전 12.6.0의 새로운 기능

timeout
int

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

반환

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

반환 형식

int

change

활성 임대의 임대 ID를 변경합니다. 변경 내용에는 x-ms-lease-id의 현재 임대 ID와 x-ms-proposed-lease-id의 새 임대 ID가 포함되어야 합니다.

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

매개 변수

proposed_lease_id
str
필수

GUID 문자열 형식의 제안된 임대 ID입니다. 제안된 임대 ID가 올바른 형식이 아닌 경우 파일 또는 공유 서비스에서 오류(잘못된 요청)가 발생합니다.

timeout
int

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

반환

없음

release

임대를 해제합니다. 요청에 지정된 임대 ID가 공유 또는 파일과 연결된 임대 ID와 일치하는 경우 임대가 해제될 수 있습니다. 임대를 해제하면 릴리스가 완료되는 즉시 다른 클라이언트가 공유 또는 파일에 대한 임대를 즉시 획득할 수 있습니다.

release(**kwargs: Any) -> None

매개 변수

timeout
int

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

반환

없음

renew

공유 임대를 갱신합니다.

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

버전 12.6.0의 새로운 기능

renew(**kwargs: Any) -> None

매개 변수

timeout
int

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

반환

없음