컨테이너 임대
이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

컨테이너 임대

 

Lease Container 설정 하 고 삭제 작업에 대 한 컨테이너에 대 한 잠금을 관리 하는 작업입니다. 잠금 기간은 15~60초 사이 또는 무한일 수 있습니다.

Lease Container 5 개 모드 중 하나에서 작업을 호출할 수 있습니다.

  • Acquire, 새로운 임대를 요청할 수 있습니다.

  • Renew, 를 기존 임대를 갱신할 수 있습니다.

  • Change, 를 기존 임대의 ID를 변경 합니다.

  • Release, 임대를 해제 하는 경우 다른 클라이언트가 컨테이너에 대 한 임대를 즉시 획득할 수 있도록 더 이상 필요 합니다.

  • Break, 을를 임대를 종료 하지만 현재 임대 기간이 만료 될때까지 다른 클라이언트가 새로운 임대를 획득 수 없습니다 있는지 확인 합니다.

System_CAPS_note참고

Lease Container 작업은 2012-02-12 버전에서 사용할 수 있는 버전과 새 버전입니다.

Lease Container 다음과 같이 요청을 생성할 수 있습니다. HTTPS를 사용하는 것이 좋습니다. 대체 myaccount 저장소 계정의 이름으로:

방법

요청 URI

HTTP 버전

PUT

https://myaccount.blob.core.windows.net/mycontainer?comp=lease&restype=container

HTTP/1.1

루트 컨테이너를 지정 하려면 입력 $root 컨테이너 이름으로 합니다.

에 에뮬레이트된 저장소 서비스에 대 한 요청을 수행할 때는 에뮬레이터 호스트 이름 및 Blob 서비스 포트를 지정 127.0.0.1:10000, 뒤에 에뮬레이트된 저장소 계정 이름을,:

방법

요청 URI

HTTP 버전

PUT

http://127.0.0.1:10000/mycontainer?comp=lease&restype=container

HTTP/1.0

HTTP/1.1

자세한 내용은 참조 Azure 저장소 에뮬레이터를 사용 하 여 개발 및 테스트에 대 한.

요청 URI에 다음과 같은 추가 매개 변수를 지정할 수 있습니다.

인자

설명

timeout

선택 사항입니다. timeout 매개 변수는 초 단위로 표시 합니다. 자세한 내용은 참조 Blob 서비스 작업에 대한 제한 시간 설정합니다.

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.

요청 헤더

설명

Authorization

필수 사항입니다. 인증 체계, 계정 이름 및 서명을 지정합니다. 자세한 내용은 참조 Azure 저장소 서비스에 대한 인증합니다.

Date 또는 x-ms-date

필수 사항입니다. 요청의 UCT(협정 세계시)를 지정합니다. 자세한 내용은 참조 Azure 저장소 서비스에 대한 인증합니다.

x-ms-version

선택 사항입니다. 이 요청에 사용할 작업의 버전을 지정합니다. 자세한 내용은 참조 Azure 저장소 서비스에 대 한 버전 관리합니다.

x-ms-lease-id: <ID>

임대 갱신, 변경 또는 해제 시 필수입니다.

x-ms-lease-id 모든 유효한 GUID 문자열 형식에 지정할 수 있습니다. 참조 Guid 생성자 (문자열) 목록은 유효한 GUID 문자열 형식입니다.

x-ms-lease-action: <acquire | renew | change | release | break>

acquire: 새로운 임대를 요청합니다. 컨테이너에 활성 임대가 없으면, Blob 서비스가 컨테이너에 대한 임대를 만들고 새로운 임대 ID를 반환합니다. 컨테이너에 활성 임대가, 활성 임대 ID를 사용 하 여 새로운 임대를 요청할 수만 있지만 새 지정할 수 있습니다 x-ms-lease duration, 을 비롯 하 여 음수 (-1)에 대 한 만료 되지않는 임대 합니다.

renew: 임대를 갱신합니다. 요청에 지정된 임대 ID가 컨테이너와 연결된 임대 ID와 일치할 경우 임대를 갱신할 수 있습니다. 임대가 만료되었더라도 컨테이너가 임대 만료 후 다시 임대되지 않은 경우에 한해 임대를 갱신할 수 있습니다. 임대를 갱신하면 임대 기간 시간이 재설정됩니다.

change: 활성 임대의 임대 ID를 변경합니다. A change x-ms-제안-임대-id에 현재 ms 임대 id x에에서 임대 ID와 새로운 임대 ID를 포함 해야 합니다.

release: 임대를 해제합니다. 요청에 지정된 임대 ID가 컨테이너와 연결된 임대 ID와 일치할 경우 임대를 해제할 수 있습니다. 임대를 해제하면 해제가 완료되는 즉시 다른 클라이언트가 해당 컨테이너에 대한 임대를 획득할 수 있습니다.

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

중단된 임대도 해제할 수 있습니다. 클라이언트는 해제된 컨테이너 임대를 즉시 획득할 수 있습니다.

x-ms-lease-break-period: N

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

x-ms-lease-duration: -1 | N

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

x-ms-proposed-lease-id: <ID>

에 대 한 선택적 acquire, 에 대 한 필수 change합니다. GUID 문자열 형식의 제안된 임대 ID입니다. Blob 서비스 반환 400 (Invalid request) 제안된 된 임대 ID에 올바른 형식이 없는 경우. 참조 Guid 생성자 (문자열) 목록은 유효한 GUID 문자열 형식입니다.

Origin

선택 사항입니다. 요청을 실행한 원본을 지정합니다. 이 헤더가 있으면 응답에 크로스-원본 자원 공유 헤더가 생성됩니다. 참조 크로스-원본 자원 공유 Azure 저장소 서비스에 대 한 (CORS) 지원 대 한 자세한 내용은 합니다.

x-ms-client-request-id

선택 사항입니다. 저장소 분석 로깅을 사용하도록 설정되어 있으면 분석 로그에 기록되는 1KB 문자 제한의 클라이언트에서 생성한 불투명 값을 제공합니다. 클라이언트 쪽 작업과 서버가 받은 요청의 상관 관계를 지정하는 데 이 헤더를 사용하는 것이 좋습니다. 자세한 내용은 참조 저장소 분석 로깅 정보Azure 로깅: 저장소 요청 추적 로그를 사용 하 여.

이 작업은 또한 지정된 조건이 충족될 경우에만 작업을 실행하는 조건부 헤더 사용을 지원합니다. 자세한 내용은 참조 Blob 서비스 작업에 대 한 조건부 헤더 지정합니다.

다음 예제 요청은 임대를 획득하는 방법을 보여줍니다.


Request Syntax: PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=lease HTTP/1.1 Request Headers: x-ms-version: 2012-02-12 x-ms-lease-action: acquire x-ms-lease-duration: -1 x-ms-proposed-lease-id: 1f812371-a41d-49e6-b123-f4b542e851c5 x-ms-date: Thu, 26 Jan 2012 23:30:18 GMT Authorization: SharedKey testaccount1:esSKMOYdK4o+nGTuTyeOLBI+xqnqi6aBmiW4XI699+o=

응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.

임대 작업에 대해 반환되는 성공 상태 코드는 다음과 같습니다.

  • Acquire: 작업에 성공하면 상태 코드 201(만들어짐)이 반환됩니다.

  • Renew: 작업에 성공하면 상태 코드 200(정상)이 반환됩니다.

  • Change: 작업에 성공하면 상태 코드 200(정상)이 반환됩니다.

  • Release: 작업에 성공하면 상태 코드 200(정상)이 반환됩니다.

  • Break: 작업에 성공하면 상태 코드 202(수락됨)가 반환됩니다.

상태 코드에 대 한 정보를 참조 하십시오. 상태 및 오류 코드합니다.

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다. 모든 표준 헤더를 준수 하는 HTTP/1.1 프로토콜 사양.

구문

설명

ETag

컨테이너에 대한 ETag입니다. 이 헤더는 2013-08-15 이상 버전에 대해 수행된 요청의 경우 반환되며 ETag 값이 따옴표로 표시됩니다. Lease Container 이상 버전 2013-08-15에 대해 수행 된 작업에이 속성을 수정 하지 마십시오 하지 않지만 이전 버전입니다.

Last-Modified

이 헤더는 2013-08-15 버전에 대 한 요청에 대 한 반환 된 이상. 컨테이너가 마지막으로 수정된 날짜 및 시간을 반환합니다. 날짜 형식은 RFC 1123을 따릅니다. 자세한 내용은 참조 헤더의 날짜/시간 값 표현합니다.

컨테이너 또는 해당 속성이나 메타데이터를 수정하는 모든 작업을 수행하면 컨테이너의 권한 설정을 포함하여 마지막 수정 시간이 업데이트됩니다. blob에 대한 작업은 컨테이너의 마지막 수정 시간에 영향을 주지 않습니다. Lease Container 이상 버전 2013-08-15에 대해 수행 된 작업에이 속성을 수정 하지 마십시오 있지만 이전 버전에서 실행 합니다.

x-ms-lease-id: <id>

임대를 요청하면 Blob 서비스가 고유한 임대 ID를 반환합니다. 임대가 활성화되어 있는 동안에는 컨테이너 삭제, 임대 갱신, 변경 또는 해제를 위한 모든 요청에 이 임대 ID를 포함해야 합니다.

또한 갱신 작업에 성공하면 활성 임대의 임대 ID가 반환됩니다.

x-ms-lease-time: seconds

임대 기간에 남은 대략적인 시간(초)입니다. 이 헤더는 임대 중단 요청이 성공한 경우에만 반환됩니다. 중단이 즉각적이면 0이 반환됩니다.

x-ms-request-id

이 헤더는 수행된 요청을 고유하게 식별하며, 이 헤더를 사용해서 요청 문제를 해결할 수 있습니다. 자세한 내용은 참조 API 작업 문제해결합니다.

x-ms-version

요청을 실행하는 데 사용되는 Blob 서비스의 버전을 나타냅니다. 이 헤더는 2009-09-19 버전 이상에 대해 수행된 요청에 대해 반환됩니다.

날짜

응답이 시작된 시간을 나타내는 서비스에서 생성된 UTC 날짜/시간 값입니다.

Access-Control-Allow-Origin

요청에 포함 된 경우 반환 되는 Origin 헤더 고 CORS가 일치 규칙과 함께 설정 합니다. 일치할 경우 이 헤더는 원본 요청 헤더의 값을 반환합니다.

Access-Control-Expose-Headers

요청에 포함 된 경우 반환 되는 Origin 헤더 고 CORS가 일치 규칙과 함께 설정 합니다. 클라이언트 또는 요청 실행자에 노출될 응답 헤더의 목록을 반환합니다.

Access-Control-Allow-Credentials

요청에 포함 된 경우 반환 되는 Origin 헤더 고 CORS가 모든 원본을 허용 하지 않는 일치 규칙과 함께 설정 합니다. 이 헤더는 true로 설정됩니다.

다음은 임대를 획득하기 위한 요청의 샘플 응답입니다.

Response Status: HTTP/1.1 201 Created Response Headers: Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0 x-ms-request-id: cc6b209a-b593-4be1-a38a-dde7c106f402 x-ms-version: 2012-02-12 x-ms-lease-id: 1f812371-a41d-49e6-b123-f4b542e851c5 Date: Thu, 26 Jan 2012 23:30:18 GMT

계정 소유자만 이 작업을 호출할 수 있습니다.

컨테이너를 임대하면 해당 컨테이너에 대한 배타적인 삭제 액세스 권한이 제공됩니다. 컨테이너 임대를 사용 하 여 컨테이너 삭제 기능만 제어는 컨테이너 삭제 작업 합니다. 활성 임대가 있는 컨테이너를 삭제하려면 클라이언트의 삭제 요청에 활성 임대 ID가 포함되어야 합니다. 임대 ID가 포함되지 않으면 작업이 실패하고 412(전제 조건 실패)가 표시됩니다. 다른 모든 컨테이너 작업은 임대 ID를 포함하지 않아도 임대된 컨테이너에서 성공합니다. 임대 권한은 임대를 획득할 때 지정된 기간 동안 부여되며, 15초에서 1분 사이 또는 기간이 무한일 수 있습니다.

클라이언트가 임대를 획득하면 임대 ID가 반환됩니다. 획득 요청에 임대 ID가 지정되지 않았으면 Blob 서비스가 임대 ID를 생성합니다. 클라이언트는 이 임대 ID를 사용해서 임대를 갱신하거나, 해당 ID를 변경하거나, 임대를 해제할 수 있습니다. 다음 다이어그램은 5가지 임대 상태와 임대 상태를 변경하는 명령 또는 이벤트를 보여줍니다.

다음 다이어그램은 5가지 임대 상태와 임대 상태를 변경하는 명령 또는 이벤트를 보여줍니다.

컨테이너 임대 상태 및 상태 변경 트리거

임대 상태

임대는 해당 임대가 잠금 또는 잠금 해제 상태인지 여부 및 해당 상태의 임대를 갱신할 수 있는지 여부에 따라 5개 상태로 구분됩니다. 위 임대 작업은 상태 전환을 일으킵니다.

잠긴 임대

잠금이 해제된 임대

갱신 가능한 임대

임대됨

만료됨

갱신할 수 없는 임대

중단

중단, 사용 가능

  • Available, 임대가 잠금해제 되어 획득할 수 있습니다. 허용 되는 작업: acquire.

  • Leased, 임대 잠겨 있습니다. 허용 되는 작업: acquire (동일한 임대 ID만), renew, change, release, 및 break합니다.

  • Expired, 임대 기간이 만료 되었습니다. 허용 되는 작업: acquire, renew, release, 및 break합니다.

  • Breaking, 임대 연결이 끊어진 하지만 임대는 중단 기간이 만료 될 때까지 잠글 계속 됩니다. 허용 되는 작업: releasebreak합니다.

  • Broken, 임대는 중단 되었으며 중단 기간이 만료 되었습니다. 허용 되는 작업: acquire, release, 및 break합니다.

임대 ID는 컨테이너 임대가 만료된 후 Blob 서비스에서 유지 관리됩니다. 클라이언트는 만료된 임대 ID를 사용해서 임대를 갱신하거나 해제할 수 있습니다. 클라이언트가 이전 임대 ID를 사용해서 만료된 임대를 갱신하거나 해제하려고 시도할 때 요청이 실패하면 컨테이너가 다시 임대되었거나 임대가 마지막으로 활성화된 시간 이후에 삭제되었음을 알 수 있습니다. 임대가 명시적으로 해제되지 않고 만료될 경우, 클라이언트가 컨테이너에서 새로운 임대를 획득하려면 먼저 최대 1분까지 기다려야 할 수 있습니다. 하지만 클라이언트는 만료된 임대 ID를 사용해서 임대를 즉시 갱신할 수 있습니다.

컨테이너의 Last-Modified-Time 를 호출 하 여 속성이 업데이트 되지 않습니다 Lease Container합니다.

다음 표에서는 다양한 상태의 임대가 포함된 컨테이너에 대한 작업의 결과를 보여줍니다. 문자 (A), (B), (C)는 임대 ID를 나타내고, (X)는 Blob 서비스로 생성된 임대 ID를 나타냅니다.

컨테이너에 대한 임대 상태별 사용 시도 결과

사용할 수 있음

임대됨 (A)

중단 (A)

중단됨 (A)

만료됨 (A)

삭제 사용 중 (A)

실패 (412)

임대됨 (A), 삭제 성공

중단 (A), 삭제 성공

실패 (412)

실패 (412)

삭제 사용 중 (B)

실패 (412)

실패 (409)

실패 (412)

실패 (412)

실패 (412)

삭제, 임대가 지정되지 않음

사용할 수 있음, 삭제 성공

실패 (412)

실패 (412)

사용할 수 있음, 삭제 성공

사용할 수 있음, 삭제 성공

다른 작업 사용 중 (A)

실패 (412)

임대됨 (A), 작업 성공

중단 (A), 작업 성공

실패 (412)

실패 (412)

다른 작업 사용 중 (B)

실패 (412)

실패 (409)

실패 (409)

실패 (412)

실패 (412)

다른 작업, 지정된 임대 없음

사용할 수 있음, 작업 성공

임대됨 (A), 작업 성공

중단 (A), 작업 성공

중단됨 (A), 작업 성공

만료됨 (A), 작업 성공

컨테이너에 대한 임대 상태별 임대 작업 결과

사용할 수 있음

임대됨 (A)

중단 (A)

중단됨 (A)

만료됨 (A)

Acquire, 더 제안 된 임대 ID

임대됨 (X)

실패 (409)

실패 (409)

임대됨 (X)

임대됨 (X)

Acquire (A)

임대됨 (A)

임대됨 (A), 새 기간

실패 (409)

임대됨 (A)

임대됨 (A)

Acquire (B)

임대됨 (B)

실패 (409)

실패 (409)

임대됨 (B)

임대됨 (B)

Break, 기간 = 0

실패 (409)

중단됨 (A)

중단됨 (A)

중단됨 (A)

중단됨 (A)

Break, 기간 > 0

실패 (409)

중단 (A)

중단 (A)

중단됨 (A)

중단됨 (A)

Change, (A)에서 (B)

실패 (409)

임대됨 (B)

실패 (409)

실패 (409)

실패 (409)

Change, (B)에서 (A)

실패 (409)

임대됨 (A)

실패 (409)

실패 (409)

실패 (409)

Change, (B)에서 (C)

실패 (409)

실패 (409)

실패 (409)

실패 (409)

실패 (409)

Renew (A)

실패 (409)

임대됨 (A), 만료 시간 재설정

실패 (409)

실패 (409)

임대됨 (A)

Renew (B)

실패 (409)

실패 (409)

실패 (409)

실패 (409)

실패 (409)

Release (A)

실패 (409)

사용할 수 있음

사용할 수 있음

사용할 수 있음

사용할 수 있음

Release (B)

실패 (409)

실패 (409)

실패 (409)

실패 (409)

실패 (409)

기간 만료

사용할 수 있음

만료됨 (A)

중단됨 (A)

중단됨 (A)

만료됨 (A)

표시:
© 2016 Microsoft