계정 정보 가져오기
작업은 Get Account Information 지정된 계정에 대한 SKU 이름 및 계정 종류를 반환합니다. 버전 2018-03-28 이상 버전에서 사용할 수 있습니다.
요청
공유 키 또는 SAS(공유 액세스 서명) 권한 부여를 통해 권한이 부여된 유효한 요청을 사용하여 요청을 생성 Get Account Information 할 수 있습니다.
의 값과 값을 추가 restype 하면 요청에서 작업을 사용합니다Get Account Information.propertiescompaccount 다음 표에서는 예제를 보여 줍니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
GET/HEAD |
https://myaccount.blob.core.windows.net/?restype=account&comp=properties |
HTTP/1.1 |
GET/HEAD |
https://myaccount.blob.core.windows.net/?restype=account&comp=properties&sv=myvalidsastoken |
HTTP/1.1 |
GET/HEAD |
https://myaccount.blob.core.windows.net/mycontainer/?restype=account&comp=properties&sv=myvalidsastoken |
HTTP/1.1 |
GET/HEAD |
https://myaccount.blob.core.windows.net/mycontainer/myblob?restype=account&comp=properties&sv=myvalidsastoken |
HTTP/1.1 |
URI 매개 변수
요청 URI에 다음과 같은 추가 매개 변수를 지정할 수 있습니다.
| 매개 변수 | Description |
|---|---|
restype |
필수 사항입니다. 매개 변수 값은 restype 이어야 account합니다. |
comp |
필수 사항입니다. 매개 변수 값은 comp 이어야 properties합니다. |
요청 헤더
다음 표에서는 필수 및 선택적 요청 헤더에 대해 설명합니다.
| 요청 헤더 | Description |
|---|---|
Authorization |
필수 사항입니다. 권한 부여 체계, 계정 이름 및 서명을 지정합니다. 자세한 내용은 Azure Storage에 대한 요청 권한 부여를 참조하세요. |
Date or x-ms-date |
필수 사항입니다. 요청에 대한 UTC(협정 세계시)를 지정합니다. 자세한 내용은 Azure Storage에 대한 요청 권한 부여를 참조하세요. |
x-ms-version |
모든 권한 있는 요청에 필요합니다. 이 요청에 사용할 작업의 버전을 지정합니다. 이 작업의 경우 버전은 2018-03-28 이상이어야 합니다. 자세한 내용은 Azure Storage 서비스에 대한 버전 관리를 참조하세요. |
x-ms-client-request-id |
선택 사항입니다. 로깅이 구성될 때 로그에 기록되는 1키비바이트(KiB) 문자 제한으로 클라이언트에서 생성된 불투명 값을 제공합니다. 이 헤더를 사용하여 클라이언트 쪽 활동과 서버가 수신하는 요청의 상관 관계를 지정하는 것이 좋습니다. |
요청 본문
없음
응답
응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.
상태 코드
작업에 성공하면 상태 코드 200(정상)이 반환됩니다.
상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하세요.
응답 헤더
이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더도 포함될 수 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 준수합니다.
| 응답 헤더 | Description |
|---|---|
x-ms-request-id |
만들어진 요청을 고유하게 식별합니다. 요청을 해결하는 데 사용할 수 있습니다. 자세한 내용은 API 작업 문제 해결을 참조하세요. |
x-ms-version |
버전 2009-09-19 이상. 요청을 실행하는 데 사용되는 Azure Blob Storage 버전을 나타냅니다. |
Date |
서비스에서 응답을 보낸 시간을 나타내는 UTC 날짜/시간 값입니다. |
Content-Length |
요청 본문의 길이를 지정합니다. 이 작업의 경우 콘텐츠 길이는 항상 0입니다. |
x-ms-sku-name |
지정된 계정의 SKU 이름을 식별합니다. |
x-ms-account-kind |
지정된 계정의 계정 종류를 식별합니다. 가능한 값은 Storage, BlobStorage 및 StorageV2입니다. 헤더는 GPv2 계정에 대한 부분 문자열 V2 을 사용하여 GPv1(범용 v1)과 GPv2(범용 v2) 스토리지 계정을 구분합니다. |
x-ms-client-request-id |
요청 및 해당 응답 문제를 해결하는 데 사용할 수 있습니다. 이 헤더의 값은 헤더 값 x-ms-client-request-id 과 같으며, 요청에 있고 값이 최대 1,024자 표시 ASCII 문자인 경우 입니다. 헤더가 x-ms-client-request-id 요청에 없는 경우 이 헤더는 응답에 존재하지 않습니다. |
x-ms-is-hns-enabled |
버전 2019-07-07 이상. 계정에 계층 구조 네임스페이스가 사용하도록 설정되어 있는지를 나타냅니다. |
응답 본문
없음
샘플 응답
Response Status:
HTTP/1.1 200 OK
Response Headers:
Date: Sat, 28 Mar 2018 12:43:08 GMT
x-ms-version: 2018-03-28
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
Content-Length: 0
x-ms-sku-name: Standard_LRS
x-ms-account-kind: StorageV2
권한 부여
Azure Storage에서 데이터 액세스 작업을 호출할 때 권한 부여가 필요합니다. 아래에 설명된 대로 작업에 권한을 부여할 Get Account Information 수 있습니다.
이 작업은 Azure Active Directory/MSI 또는 사용자 위임 SAS의 액세스 토큰을 통한 OAuth 기반 권한 부여를 지원하지 않습니다.
설명
요청의 URL 경로는 이 작업이 제공하는 정보에 영향을 주지 않습니다. 요청이 허용된 리소스를 지정하는 SAS 토큰으로 올바르게 권한을 부여하도록 허용하는 것이 목적입니다.
이 작업이 성공하기 위해 지정된 리소스가 존재하지 않아도 됩니다. 예를 들어 존재하지 않는 Blob 및 유효한 권한으로 생성된 SAS 토큰은 올바른 계정 이름, 올바른 컨테이너 이름 및 존재하지 않는 Blob의 이름을 포함하는 URL 경로로 성공합니다.
결제
가격 책정 요청은 Blob Storage REST API를 통해 직접 또는 Azure Storage 클라이언트 라이브러리에서 Blob Storage API를 사용하는 클라이언트에서 시작됩니다. 이러한 요청은 트랜잭션당 요금을 발생합니다. 트랜잭션 유형은 계정 청구 방식에 영향을 줍니다. 예를 들어 읽기 트랜잭션은 쓰기 트랜잭션이 아닌 다른 청구 범주에 발생합니다. 다음 표에서는 스토리지 계정 유형에 따라 요청에 대한 Get Account Information 청구 범주를 보여 줍니다.
| 작업 | Storage 계정 유형 | 청구 범주 |
|---|---|---|
| 계정 정보 가져오기 | 프리미엄 블록 Blob 표준 범용 v2 |
기타 작업 |
| 계정 정보 가져오기 | 표준 범용 v1 | 읽기 작업 |
지정된 청구 범주의 가격 책정에 대한 자세한 내용은 가격 책정 Azure Blob Storage 참조하세요.