계정 정보 가져오기

아티클
12/12/2024

Get Account Information 작업은 지정된 계정의 SKU 이름 및 계정 종류를 반환합니다. 2018-03-28 버전 이상 버전의 서비스에서 사용할 수 있습니다.

요청

공유 키 또는 SAS(공유 액세스 서명) 권한 부여를 통해 권한이 부여된 유효한 요청을 사용하여 Get Account Information 요청을 생성할 수 있습니다.

account restype 값과 propertiescomp 값을 추가하는 경우 요청은 Get Account Information 작업을 사용합니다. 다음 표에서는 예제를 보여 줍니다.

메서드	요청 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에 다음 추가 매개 변수를 지정할 수 있습니다.

매개 변수	묘사
`restype`	필수. `restype` 매개 변수 값은 `account`합니다.
`comp`	필수. `comp` 매개 변수 값은 `properties`합니다.

요청 헤더

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

요청 헤더	묘사
`Authorization`	필수. 권한 부여 체계, 계정 이름 및 서명을 지정합니다. 자세한 내용은 Azure Storage대한 요청 권한 부여를 참조하세요.
`Date or x-ms-date`	필수. 요청에 대한 UTC(협정 세계시)를 지정합니다. 자세한 내용은 Azure Storage대한 요청 권한 부여를 참조하세요.
`x-ms-version`	모든 권한 있는 요청에 필요합니다. 이 요청에 사용할 작업의 버전을 지정합니다. 이 작업의 경우 버전은 2018-03-28 이상이어야 합니다. 자세한 내용은 Azure Storage 서비스대한 버전 관리를 참조하세요.
`x-ms-client-request-id`	선택적. 로깅이 구성될 때 로그에 기록되는 1kibibyte(KiB) 문자 제한으로 클라이언트에서 생성된 불투명 값을 제공합니다. 이 헤더를 사용하여 클라이언트 쪽 활동과 서버가 수신하는 요청의 상관 관계를 지정하는 것이 좋습니다.

요청 본문

없음.

응답

응답에는 HTTP 상태 코드와 응답 헤더 집합이 포함됩니다.

상태 코드

작업이 성공하면 상태 코드 200(확인)이 반환됩니다.

상태 코드에 대한 자세한 내용은 상태 및 오류 코드참조하세요.

응답 헤더

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

응답 헤더	묘사
`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`	요청 및 해당 응답 문제를 해결하는 데 사용할 수 있습니다. 이 헤더의 값은 요청에 있고 값이 최대 1,024개의 표시되는 ASCII 문자인 경우 `x-ms-client-request-id` 헤더의 값과 같습니다. 요청에 `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 작업에 권한을 부여할 수 있습니다.

중요하다

Microsoft는 관리 ID와 함께 Microsoft Entra ID를 사용하여 Azure Storage에 대한 요청을 승인하는 것이 좋습니다. Microsoft Entra ID는 공유 키 권한 부여에 비해 뛰어난 보안 및 사용 편의성을 제공합니다.

microsoft Entra ID(권장)
SAS(공유 액세스 서명)
공유 키

Azure Storage는 Microsoft Entra ID를 사용하여 Blob 데이터에 대한 요청을 승인하도록 지원합니다. Microsoft Entra ID를 사용하면 Azure RBAC(Azure 역할 기반 액세스 제어)를 사용하여 보안 주체에 권한을 부여할 수 있습니다. 보안 주체는 사용자, 그룹, 애플리케이션 서비스 주체 또는 Azure 관리 ID일 수 있습니다. 보안 주체는 OAuth 2.0 토큰을 반환하기 위해 Microsoft Entra ID에 의해 인증됩니다. 그런 다음 토큰을 사용하여 Blob 서비스에 대한 요청에 권한을 부여할 수 있습니다.

Microsoft Entra ID를 사용한 권한 부여에 대한 자세한 내용은 Microsoft Entra ID사용하여 Blob에 대한 액세스 권한 부여를 참조하세요.

권한을

다음은 Microsoft Entra 사용자, 그룹, 관리 ID 또는 서비스 주체가 Get Account Information 작업을 호출하는 데 필요한 RBAC 작업입니다.

Azure RBAC 작업 : Microsoft.Storage/storageAccounts/blobServices/getInfo/action

이 RBAC 작업은 소유자 역할에 포함되거나 사용자 지정 역할에 이 작업을 할당할 수 있습니다.

Azure RBAC를 사용하여 역할을 할당하는 방법에 대한 자세한 내용은 Blob 데이터액세스하기 위한 Azure 역할 할당을 참조하세요.

SAS(공유 액세스 서명)는 스토리지 계정의 리소스에 대한 보안 위임된 액세스를 제공합니다. SAS를 사용하면 클라이언트가 데이터에 액세스하는 방법을 세부적으로 제어할 수 있습니다. 클라이언트가 액세스할 수 있는 리소스, 해당 리소스에 대한 사용 권한 및 SAS가 유효한 기간을 지정할 수 있습니다.

Get Account Information 작업은 계정 SAS를 사용한 권한 부여를 지원합니다.

계정 SAS

계정 SAS는 스토리지 계정 키로 보호됩니다. 계정 SAS는 하나 이상의 스토리지 서비스에서 리소스에 대한 액세스를 위임합니다. 서비스 또는 사용자 위임 SAS를 통해 사용할 수 있는 모든 작업은 계정 SAS를 통해서도 사용할 수 있습니다.

계정 SAS에 대한 자세한 내용은 계정 SAS만들기를 참조하세요.

발언

요청의 URL 경로는 이 작업이 제공하는 정보에 영향을 주지 않습니다. 요청이 허용된 리소스를 지정하는 SAS 토큰으로 올바르게 권한을 부여하도록 허용하는 것이 목적입니다.

이 작업이 성공하기 위해 지정된 리소스가 존재하지 않아도 됩니다. 예를 들어 존재하지 않는 Blob 및 유효한 권한으로 생성된 SAS 토큰은 올바른 계정 이름, 올바른 컨테이너 이름 및 존재하지 않는 Blob의 이름을 포함하는 URL 경로로 성공합니다.

과금

가격 책정 요청은 Blob Storage REST API를 통해 직접 Blob Storage API를 사용하는 클라이언트 또는 Azure Storage 클라이언트 라이브러리에서 비롯할 수 있습니다. 이러한 요청은 트랜잭션당 요금이 발생합니다. 트랜잭션 유형은 계정에 청구되는 방식에 영향을 줍니다. 예를 들어 읽기 트랜잭션은 쓰기 트랜잭션과 다른 청구 범주에 발생합니다. 다음 표에서는 스토리지 계정 유형에 따라 Get Account Information 요청에 대한 청구 범주를 보여 줍니다.

수술	스토리지 계정 유형	청구 범주
계정 정보 가져오기	프리미엄 블록 Blob 표준 범용 v2	기타 작업
계정 정보 가져오기	표준 범용 v1	읽기 작업

지정된 청구 범주의 가격 책정에 대한 자세한 내용은 Azure Blob Storage 가격 책정참조하세요.

다음을 통해 공유