다음을 통해 공유

저장소 계정 속성 가져오기

  • 아티클

 

Get Storage Account Properties 작업에 지정 된 저장소 계정의 시스템 속성을 반환 합니다.

요청

Get Storage Account Properties 요청을 다음과 같이 지정할 수 있습니다. 대체 <subscription-id> 구독 ID로 및 <storage-account-name> 저장소 계정의 이름으로 합니다.

방법 요청 URI
GET https://management.core.windows.net/<subscription-id>/services/storageservices/<storage-account-name>

관리 서비스에 대한 요청이 안전한지 확인해야 합니다. 추가 세부 정보를 참조 하십시오. 서비스 관리 요청 인증.

URI 매개 변수

없음.

요청 헤더

다음 표에서는 요청 헤더에 대해 설명합니다.

요청 헤더 설명
x-ms-version 필수 사항입니다. 이 요청에 사용할 작업의 버전을 지정합니다. 이 헤더 설정 해야 2009-10-01 이상. 버전 관리 헤더에 대 한 자세한 내용은 참조 서비스 관리 버전 관리.

요청 본문

없음.

응답

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

상태 코드

작업에 성공하면 상태 코드 200(정상)이 반환됩니다. 상태 코드에 대 한 정보를 참조 하십시오. 서비스 관리 상태 및 오류 코드.

응답 헤더

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

응답 헤더 설명
x-ms-request-id 관리 서비스에 대해 수행된 요청을 고유하게 식별하는 값입니다.

응답 본문

응답 본문의 형식은 다음과 같습니다.

  
<?xml version="1.0" encoding="utf-8"?> <StorageService xmlns="https://schemas.microsoft.com/windowsazure"> <Url>storage-account-request-uri</Url> <ServiceName>storage-account-name</ServiceName> <StorageServiceProperties> <Description>description</Description> <AffinityGroup>affinity-group</AffinityGroup> <Location>location</Location> <Label>base64-encoded-label</Label> <Status>status</Status> <Endpoints> <Endpoint>storage-service-blob-endpoint</Endpoint> <Endpoint>storage-service-queue-endpoint</Endpoint> <Endpoint>storage-service-table-endpoint</Endpoint> <Endpoint>storage-service-file-endpoint</Endpoint> </Endpoints> <GeoReplicationEnabled>geo-replication-indicator</GeoReplicationEnabled> <GeoPrimaryRegion>primary-region</GeoPrimaryRegion> <StatusOfPrimary>primary-status</StatusOfPrimary> <LastGeoFailoverTime>DateTime</LastGeoFailoverTime> <GeoSecondaryRegion>secondary-region</GeoSecondaryRegion> <StatusOfSecondary>secondary-status</StatusOfSecondary> <CreationTime>time-of-creation</CreationTime> <CustomDomains> <CustomDomain> <Name>name-of-custom-domain</Name> </CustomDomain> </CustomDomains> <SecondaryReadEnabled>secondary-read-indicator</SecondaryReadEnabled> <SecondaryEndpoints> <Endpoint>storage-secondary-service-blob-endpoint</Endpoint> <Endpoint>storage-secondary-service-queue-endpoint</Endpoint> <Endpoint>storage-secondary-service-table-endpoint</Endpoint> </SecondaryEndpoints> <AccountType>type-of-storage-account</AccountType> </StorageServiceProperties> <ExtendedProperties> <ExtendedProperty> <Name>property-name</Name> <Value>property-value</Value> </ExtendedProperty> </ExtendedProperties> <Capabilities> <Capability>storage-account-capability</Capability> </Capabilities> </StorageService>

다음 표에서는 응답 본문의 요소에 대해 설명합니다.

요소 이름 설명
Url 저장소 URI를 지정합니다.
ServiceName 저장소 계정의 이름을 지정합니다. 이 이름은 DNS 접두사 이름이며 저장소 계정의 Blob, 큐 및 테이블에 액세스하는 데 사용할 수 있습니다.

예: 서비스 이름이 MyStorageAccount 를 호출 하 여 blob 컨테이너에 액세스할 수 있습니다: http://MyStorageAccount.blob.core.windows.net/mycontainer/
StorageServiceProperties 저장소 계정의 속성을 지정합니다.
ExtendedProperties 저장소 계정에 추가된 확장된 속성의 이름 및 값을 지정합니다.
기능 저장소 계정이 가상 컴퓨터 관련 작업을 수행할 수 있는지 여부를 나타냅니다. 수행할 수 있는 경우, 이 요소는 PersistentVMRole이 포함된 문자열을 반환합니다. 수행할 수 없는 경우 이 요소는 표시되지 않습니다.

 Capability 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만.

StorageServiceProperties

저장소 계정의 속성을 지정합니다.

요소 이름 설명
설명 선택 사항입니다. 저장소 계정에 대한 설명입니다. 설명의 길이는 최대 1024자입니다.

 Description 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만.
AffinityGroup 필요한 경우 Location 지정 하지 않았습니다. 이 구독에 연결된 기존 선호도 그룹의 이름입니다. 이 이름은 GUID 이며에서 반환 된 응답 본문의 name 요소를 검사 하 여 검색할 수는 선호도 그룹 나열 작업 합니다.

 AffinityGroup 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만.
위치 필요한 경우 AffinityGroup 지정 하지 않았습니다. 저장소 계정이 만들어질 위치입니다.

 Location 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만.
Label 필수 사항입니다. Base-64로 인코딩된 호스팅 서비스의 이름입니다. 이름의 길이는 최대 100자입니다. 저장소 계정을 식별하는 데 추적용으로 사용할 수 있는 이름입니다.

 Label 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만.
상태 저장소 계정의 상태입니다. 가능한 값은 다음과 같습니다.

- Creating
- Created
- Deleting
- Deleted
- Changing
- ResolvingDns

 Status 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만.
끝점 Blob, 테이블, 큐 및 파일 끝점입니다.

참고 1: 파일 끝점은 미리 보기 모드로 제공되고 미리 보기 지원 구독에 대해서만 반환됩니다.

참고 2: Standard_ZRS 계정 유형에 대 한 blob 끝점에만 반환 됩니다. 또한 ZRS는 페이지 Blob이 아닌 블록 Blob만 지원하므로 IaaS VM과 호환되지 않습니다.

참고 3: Premium_LRS 계정 유형에 대해서는 Blob 끝점만 반환됩니다.
GeoReplicationEnabled 저장소 계정의 데이터를 둘 이상의 지리적 위치로 복제하여 심각한 서비스 중단 시 복원 기능을 사용할지 여부를 나타냅니다. 값은 true 이 지역에서 복제 사용 하도록 설정 하 고 그렇지않으면 false.

 GeoReplicationEnabled 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만 및는 2014-06-01 버전은 AccountType 요소로 대체 이후인 경우.
GeoPrimaryRegion 현재 저장소 계정이 있는 주 지역을 나타냅니다.

 GeoPrimaryRegion 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만.
StatusOfPrimary 주 저장소 지역을 사용할 수 있는지 여부를 나타냅니다.

가능한 값은 다음과 같습니다.

- Available
- Unavailable

 StatusOfPrimary 요소는 버전 2013-11-01을 사용 하 여 사용할 수 있는 이상 에서만.
LastGeoFailoverTime 보조 지역으로 장애 조치(Failover)된 최근 인스턴스를 나타내는 타임스탬프입니다. 장애 조치(Failover)가 여러 번 수행된 경우 최신 장애 조치(Failover) 날짜 및 시간이 유지됩니다.

반환 된 타임 스탬프의 형식은: [4DigitYear]-[2DigitMonth]-[2DigitDay] T [2DigitMinute]: [2DigitSecond]: [7DigitsOfPrecision] Z

예: < LastGeoFailoverTime > 2010-01-18T13:15:30.0000000Z < / LastGeoFailoverTime >

장애 조치(Failover) 인스턴스가 없는 경우 LastGeoFailoverTime이 반환되지 않습니다.

 LastGeoFailoverTime 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만.
GeoSecondaryRegion 저장소 계정이 복제되고 있는 지역을 나타냅니다.

이 계정에 대해 지리적 복제가 "해제"인 경우에는 GeoSecondaryRegion 요소는 반환되지 않습니다.

 GeoSecondaryRegion 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만.
StatusOfSecondary 보조 저장소 지역을 사용할 수 있는지 여부를 나타냅니다.

가능한 값은 다음과 같습니다.

- Available
- Unavailable

 StatusOfSecondary 요소는 버전 2013-11-01을 사용 하 여 사용할 수 있는 이상 에서만.
CreationTime 저장소 계정을 만든 시간을 지정합니다.
CustomDomains 저장소 계정과 연결된 사용자 지정 도메인을 지정합니다.

 CustomDomains 요소는 버전 2013-06-01을 사용 하 여 사용할 수 있는 이상 에서만.
SecondaryReadEnabled 저장소 계정에 대해 보조 읽기가 설정되어 있음을 나타냅니다.

가능한 값은 다음과 같습니다.

- true
- false

 SecondaryReadEnabled 요소는 버전 2013-11-01을 사용 하 여 사용할 수 있는 이상 에서만 및는 2014-06-01 버전은 AccountType 요소로 대체 이후인 경우.
SecondaryEndpoints 저장소 계정의 보조 끝점을 지정합니다.

 SecondaryEndpoints 요소는 버전 2013-11-01을 사용 하 여 사용할 수 있는 이상 에서만.
AccountType 계정이 로컬 중복 저장소, 지역 중복 저장소, 영역 중복 저장소 또는 읽기 권한의 지역 중복 저장소를 지원하는지 여부를 지정합니다.

가능한 값은 다음과 같습니다.

- Standard_LRS
- Standard_ZRS
- Standard_GRS
- Standard_RAGRS
- Premium_LRS

 AccountType 요소는 사용할 버전 2014-06-01 이상 에서만 및 SecondaryReadEnabled 및 GeoReplicationEnabled 요소를 대체 합니다.

 Premium_LRS 요소는만 이상의 버전 2014-10-01을 사용 하 여 사용할 수 있습니다.

끝점

저장소 계정의 끝점을 지정합니다.

요소 이름 설명
끝점 다음과 같은 형식의 blob 서비스 끝점을 포함합니다. https:// <storage-service-name>.blob.core.windows.net

 Endpoint 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만. Http 끝점은 버전 2014-04-01 이전에서만 반환됩니다.
끝점 다음과 같은 형식의 큐 서비스 끝점을 포함합니다. https:// <storage-service-name>.queue.core.windows.net

 Endpoint 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만. Http 끝점은 버전 2014-04-01 이전에서만 반환됩니다.
끝점 다음과 같은 형식의 테이블 서비스 끝점을 포함합니다. https://<storage-service-name>.table.core.windows.net

 Endpoint 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만. Http 끝점은 버전 2014-04-01 이전에서만 반환됩니다.
끝점 다음과 같은 형식의 파일 서비스 끝점을 포함 합니다. https://<storage-service-name>.file.core.windows.net

 Endpoint 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만. Http 끝점은 버전 2014-04-01 이전에서만 반환됩니다.

CustomDomains

저장소 계정과 연결된 사용자 지정 도메인을 지정합니다.

요소 이름 설명
CustomDomain 저장소 계정과 연결된 사용자 지정 도메인에 대한 정보를 지정합니다.
Name 사용자 지정 도메인의 이름을 지정합니다.

SecondaryEndpoints

저장소 계정의 보조 끝점을 지정합니다.

요소 이름 설명
끝점 다음과 같은 형식의 blob 보조 서비스 끝점을 포함합니다. https://<storage-secondary-service-name>.blob.core.windows.net

Http 끝점은 버전 2014-04-01 이전에서만 반환됩니다.
끝점 다음과 같은 형식의 큐 서비스 끝점을 포함합니다. https://<storage-secondary-service-name>.queue.core.windows.net

Http 끝점은 버전 2014-04-01 이전에서만 반환됩니다.
끝점 다음과 같은 형식의 테이블 서비스 끝점을 포함합니다. https://<storage-secondary-service-name>.table.core.windows.net

Http 끝점은 버전 2014-04-01 이전에서만 반환됩니다.

ExtendedProperties

저장소 계정에 추가된 확장된 속성의 이름 및 값을 지정합니다.

요소 이름 설명
Name 선택 사항입니다. 확장 저장소 계정 속성의 이름을 나타냅니다. 각 확장 속성에는 정의된 이름과 값이 모두 있어야 합니다. 확장 속성 이름/값 쌍은 50개까지 지정할 수 있습니다.

Name 요소의 최대 길이는 64자이고, 영숫자와 밑줄만 포함할 수 있으며, 문자로 시작해야 합니다. Name에 다른 문자를 사용하거나, Name을 문자로 시작하지 않거나, 동일한 저장소 계정에서 소유하고 있는 다른 확장 속성의 이름과 동일한 이름을 입력하면 상태 코드 400(잘못된 요청) 오류가 반환됩니다.

 Name 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만.
값 선택 사항입니다. 확장 저장소 계정 속성의 값을 나타냅니다. 각 확장 속성에는 정의된 이름과 값이 모두 있어야 합니다. 확장 속성 이름/값 쌍은 50개까지 지정할 수 있으며 각 확장 속성 값의 최대 길이는 255자입니다.

 Value 요소는 버전 2012-03-01을 사용 하 여 사용할 수 있는 이상 에서만.

설명

저장소 계정을 만들거나 업데이트할 때 지리적 복제를 사용하도록 설정할 수 있습니다.

하는 경우는 x-ms-version 이 2012-03-01 이상 및 선호도 그룹의 사용 되지않는 하나에서 만들어진 Anywhere US, Anywhere Europe, Anywhere Asia 지역은 Location 요소는이 선호도 그룹이 할당 된 위치를 반환 합니다.

예제

다음 예제 프로그램에서는 구독 ID, 연결된 관리 인증서 지문, 작업 버전 문자열, 저장소 계정 이름을 사용하며 반환되는 저장소 계정 속성을 콘솔에 출력합니다. 초기화는 msVersion, subscriptionId, thumbprint 및 serviceName 예제 코드를 실행 하려면 사용자 고유의 값을 사용 하 여 변수입니다.

using System; using System.Collections.Generic; using System.Net; using System.Security.Cryptography.X509Certificates; using System.Xml; using System.Xml.Linq; class Program { static void Main(string[] args) { string msVersion = "2011-12-01"; string subscriptionId = "subscription-id-guid"; string thumbprint = "certificate-thumbprint"; string serviceName = "myexamplestorage1"; try { // Obtain the certificate with the specified thumbprint X509Certificate2 certificate = GetCertificate(thumbprint); GetStorageAccountPropertiesExample( subscriptionId, certificate, msVersion, serviceName); } catch (Exception ex) { Console.WriteLine("Exception caught in Main:"); Console.WriteLine(ex.Message); } } public static X509Certificate2 GetCertificate(string thumbprint) { List<StoreLocation> locations = new List<StoreLocation> { StoreLocation.CurrentUser, StoreLocation.LocalMachine }; foreach (var location in locations) { X509Store store = new X509Store("My", location); try { store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly); X509Certificate2Collection certificates = store.Certificates.Find( X509FindType.FindByThumbprint, thumbprint, false); if (certificates.Count == 1) { return certificates[0]; } } finally { store.Close(); } } throw new ArgumentException(string.Format( "A certificate with thumbprint '{0}' could not be located.", thumbprint)); } public static void GetStorageAccountPropertiesExample( string subscriptionId, X509Certificate2 certificate, string version, string serviceName) { string uriFormat = "https://management.core.windows.net/{0}/services/storageservices/{1}"; Uri uri = new Uri(String.Format(uriFormat, subscriptionId, serviceName)); HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(uri); request.Method = "GET"; request.Headers.Add("x-ms-version", version); request.ClientCertificates.Add(certificate); request.ContentType = "application/xml"; XDocument responseBody = null; HttpStatusCode statusCode; HttpWebResponse response; try { response = (HttpWebResponse)request.GetResponse(); } catch (WebException ex) { // GetResponse throws a WebException for 400 and 500 status codes response = (HttpWebResponse)ex.Response; } statusCode = response.StatusCode; if (response.ContentLength > 0) { using (XmlReader reader = XmlReader.Create(response.GetResponseStream())) { responseBody = XDocument.Load(reader); } } response.Close(); if (statusCode.Equals(HttpStatusCode.OK)) { XNamespace wa = "https://schemas.microsoft.com/windowsazure"; XElement storageService = responseBody.Element(wa + "StorageService"); Console.WriteLine( "Storage Account Properties for {0}:{1}{2}", serviceName, Environment.NewLine, storageService.ToString(SaveOptions.OmitDuplicateNamespaces)); } else { Console.WriteLine("Call to GetStorageAccountProperties returned an error:"); Console.WriteLine("Status Code: {0} ({1}):{2}{3}", (int)statusCode, statusCode, Environment.NewLine, responseBody.ToString(SaveOptions.OmitDuplicateNamespaces)); } return; } }