Blob 서비스 속성 가져오기

Get Blob Service Properties작업은 스토리지 분석 및 CORS (크로스-원본 자원 공유) 규칙에 대 한 속성을 포함 하 여 저장소 계정의 Blob service 속성을 가져옵니다.

CORS 규칙 및 평가 논리에 대 한 자세한 내용은 저장소 서비스에 대 한 Cors 지원을 참조 하세요.

요청

다음과 같이 Get Blob Service Properties 요청을 지정할 수 있습니다. HTTPS를 사용하는 것이 좋습니다. <account-name>를 사용자의 저장소 계정으로 바꿉니다.

방법 요청 URI HTTP 버전
GET https://<account-name>.blob.core.windows.net/?restype=service&comp=properties HTTP/1.1

경로의 호스트 이름과 URI의 쿼리 부분을 구분하기 위해 URI에는 항상 슬래시(/)가 포함되어야 합니다. 이 작업의 경우 URI의 경로 부분은 비어 있습니다.

URI 매개 변수

URI 매개 변수 설명
restype=service&comp=properties 필수 요소. 저장소 서비스 속성을 가져오려면 두 쿼리 문자열의 조합이 필요합니다.
timeout 선택 사항입니다. timeout 매개 변수는 초 단위로 표시됩니다. 자세한 내용은 Blob 서비스 작업에 대 한 시간 제한 설정을 참조 하세요.

요청 헤더

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

요청 헤더 설명
Authorization 필수 요소. 권한 부여 체계, 저장소 계정 이름 및 서명을 지정 합니다. 자세한 내용은 Azure Storage에 요청 권한 부여를 참조 하세요.
Date 또는 x-ms-date 필수 요소. 요청에 대한 UTC(협정 세계시)를 지정합니다. 자세한 내용은 Azure Storage에 요청 권한 부여를 참조 하세요.
x-ms-version 모든 권한이 부여 된 요청에 필요 합니다. 이 요청에 사용할 작업의 버전을 지정합니다. 자세한 내용은 Azure Storage Services에 대 한 버전 관리를 참조 하세요.
x-ms-client-request-id 선택 사항입니다. 저장소 분석 로깅을 사용 하도록 설정한 경우 분석 로그에 기록 되는 1 KiB 문자 제한이 있는 클라이언트 생성 불투명 값을 제공 합니다. 이 헤더를 사용하면 클라이언트 쪽 작업을 서버에서 받은 요청과 관련시키는 것이 좋습니다. 자세한 내용은 스토리지 분석 로깅Azure 로깅: 로그를 사용 하 여 저장소 요청 추적을 참조 하세요.

요청 본문

없음

응답

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

상태 코드

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

응답 헤더

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

응답 헤더 설명
x-ms-request-id 서비스에 대해 수행된 요청을 고유하게 식별하는 값입니다.
x-ms-version 응답에 사용된 작업의 버전을 지정합니다. 자세한 내용은 Azure Storage Services에 대 한 버전 관리를 참조 하세요.
x-ms-client-request-id 이 헤더를 사용 하 여 요청 및 해당 응답의 문제를 해결할 수 있습니다. 이 헤더의 값은 요청에 있는 경우 헤더의 값과 같으며 x-ms-client-request-id , 값은 최대 1024 표시 ASCII 문자입니다. x-ms-client-request-id요청에 헤더가 없는 경우이 헤더는 응답에 표시 되지 않습니다.

응답 본문

2012-02-12 및 이전 버전의 경우 응답 본문 형식은 다음과 같습니다.

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>version-number</Version>  
        <Delete>true|false</Delete>  
        <Read>true|false</Read>  
        <Write>true|false</Write>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Logging>  
    <Metrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Metrics>  
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>  
</StorageServiceProperties>  

2013-08-15 버전부터 응답 본문의 형식은 다음과 같습니다.

  
<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>version-number</Version>  
        <Delete>true|false</Delete>  
        <Read>true|false</Read>  
        <Write>true|false</Write>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Logging>  
    <HourMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>  
            <AllowedMethods>comma-separated-list-of-HTTP-verbs</AllowedMethods>  
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>  
            <ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>  
        </CorsRule>  
    </Cors>  
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>  
</StorageServiceProperties>  
  

버전 2017-07-29부터 응답 본문의 형식은 다음과 같습니다.

  
<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>version-number</Version>  
        <Delete>true|false</Delete>  
        <Read>true|false</Read>  
        <Write>true|false</Write>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Logging>  
    <HourMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>  
            <AllowedMethods>comma-separated-list-of-HTTP-verbs</AllowedMethods>  
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>  
            <ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>  
        </CorsRule>  
    </Cors>  
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>  
    <DeleteRetentionPolicy>
        <Enabled>true|false</Enabled>
        <Days>number-of-days</Days>
    </DeleteRetentionPolicy>
</StorageServiceProperties>  
  

2018-03-28부터 응답 본문의 형식은 다음과 같습니다.

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>version-number</Version>  
        <Delete>true|false</Delete>  
        <Read>true|false</Read>  
        <Write>true|false</Write>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Logging>  
    <HourMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>  
            <AllowedMethods>comma-separated-list-of-HTTP-verbs</AllowedMethods>  
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>  
            <ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>  
        </CorsRule>  
    </Cors>    
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
    <DeleteRetentionPolicy>
        <Enabled>true|false</Enabled>
        <Days>number-of-days</Days>
    </DeleteRetentionPolicy>
    <StaticWebsite>
        <Enabled>true|false</Enabled>
        <IndexDocument>default-name-of-index-page-under-each-directory</IndexDocument>
        <ErrorDocument404Path>absolute-path-of-the-custom-404-page</ErrorDocument404Path>
    </StaticWebsite>
</StorageServiceProperties>  

2019-12-12부터 응답 본문의 형식은 다음과 같습니다.

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>version-number</Version>  
        <Delete>true|false</Delete>  
        <Read>true|false</Read>  
        <Write>true|false</Write>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Logging>  
    <HourMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>  
            <AllowedMethods>comma-separated-list-of-HTTP-verbs</AllowedMethods>  
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>  
            <ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>  
        </CorsRule>  
    </Cors>    
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
    <DeleteRetentionPolicy>
        <Enabled>true|false</Enabled>
        <Days>number-of-days</Days>
    </DeleteRetentionPolicy>
    <StaticWebsite>
        <Enabled>true|false</Enabled>
        <IndexDocument>default-name-of-index-page-under-each-directory</IndexDocument>
        <DefaultIndexDocumentPath>absolute-path-of-the-default-index-page</DefaultIndexDocumentPath>
        <ErrorDocument404Path>absolute-path-of-the-custom-404-page</ErrorDocument404Path>
    </StaticWebsite>
</StorageServiceProperties>  

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

요소 이름 설명
로깅 Azure 분석 Logging 설정을 그룹화합니다.
Metrics(메트릭) Azure 분석 메트릭 설정을 그룹화 합니다. Metrics 설정은 Blob에 대한 시간별 집계에서 API로 그룹화된 요청 통계 요약을 제공합니다.
HourMetrics Azure 분석 HourMetrics 설정을 그룹화합니다. HourMetrics 설정은 Blob에 대한 시간별 집계에서 API로 그룹화된 요청 통계 요약을 제공합니다.
MinuteMetrics Azure 분석 MinuteMetrics 설정을 그룹화합니다. MinuteMetrics 설정은 Blob에 대해 매 분당 요청 통계를 제공합니다.
Version 현재 사용 중인 Storage Analytics의 버전입니다.
삭제 로깅 구성에만 적용됩니다. 삭제 요청을 기록할지 여부를 나타냅니다.
읽기 로깅 구성에만 적용됩니다. 읽기 요청을 기록할지 여부를 나타냅니다.
쓰기 로깅 구성에만 적용됩니다. 쓰기 요청을 기록할지 여부를 나타냅니다.
Enabled Blob 서비스에 대해 메트릭이 설정되었는지 여부를 나타냅니다.

읽기 액세스 지리적 중복 복제가 설정되어 있는 경우 기본 및 보조 메트릭이 모두 수집됩니다. 읽기 액세스 지리적 중복 복제가 설정되어 있지 않은 경우에는 기본 메트릭만 수집됩니다.
IncludeAPIs 메트릭 구성에만 적용됩니다. 호출된 API 작업에 대해 메트릭이 요약 통계를 생성하는지 여부를 나타냅니다.
RetentionPolicy/Enabled 저장소 서비스에 대해 보존 정책이 설정되었는지 여부를 나타냅니다.
RetentionPolicy/Days 메트릭 또는 로깅 데이터가 보존되는 일 수를 나타냅니다. 이 값보다 오래된 데이터는 모두 삭제됩니다.
DefaultServiceVersion Defaultserviceversion 은 수신 요청의 버전이 지정 되지 않은 경우 Blob service에 대 한 요청에 사용할 기본 버전을 나타냅니다. 값에는 2008-10-27 버전 이상만 포함됩니다. 해당 버전에 대 한 자세한 내용은 Azure Storage Services에 대 한 버전 관리를 참조 하세요.
모든 CORS 규칙을 그룹화합니다.
CorsRule CORS 규칙에 대한 설정을 그룹화합니다.
원본 CORS를 통해 허용되는 원본 도메인의 쉼표로 구분된 목록 또는 모든 도메인이 허용되는 경우 "*"입니다.
ExposedHeaders CORS 클라이언트에 노출할 응답 헤더의 쉼표로 구분된 목록입니다.
MaxAgeInSeconds 클라이언트/브라우저가 실행 전 응답을 캐시해야 하는 시간(초)입니다.
에서는 allowedheaders 크로스-원본 요청에 포함될 수 있는 헤더의 쉼표로 구분된 목록입니다.
AllowedMethods 원본에서 실행할 수 있도록 허용되는 HTTP 메서드의 쉼표로 구분된 목록입니다. Azure 저장소의 경우 허용되는 메서드는 DELETE, GET, HEAD, MERGE, POST, OPTIONS 또는 PUT입니다.
DeleteRetentionPolicy Azure Delete 설정을 그룹화 합니다. Blob 서비스에만 적용됩니다.
Enabled 삭제 작업을 통해 삭제 된 blob 또는 스냅숏을 유지할지 즉시 제거할지를 나타냅니다.
삭제 된 blob을 보관할 일 수를 나타냅니다. 이 값 보다 오래 된 모든 데이터는 영구적으로 삭제 됩니다.
StaticWebsite Staticwebsite 설정을 그룹화 합니다. Blob 서비스에만 적용됩니다.
StaticWebsite/Enabled 지정 된 계정에 대해 staticwebsite 지원이 사용 되는지 여부를 나타냅니다.
StaticWebsite/IndexDocument 웹 사이트 또는 하위 폴더의 루트에 대 한 요청에 Azure Storage는 웹 페이지입니다. 예: index.html. 이 값은 대/소문자를 구분합니다.
StaticWebsite/DefaultIndexDocumentPath 기존 파일과 일치 하지 않는 요청에 대해 Azure Storage는 웹 페이지의 절대 경로입니다. 페이지의 내용이와 함께 반환 됩니다 HTTP 200 OK . 예: index.html. 요소는와 함께 사용할 수 없습니다 StaticWebsite/IndexDocument . 이 값은 대/소문자를 구분합니다.
StaticWebsite/ErrorDocument404Path 기존 파일과 일치 하지 않는 요청에 대해 Azure Storage는 웹 페이지의 절대 경로입니다. 페이지의 내용이와 함께 반환 됩니다 HTTP 404 Not Found . 예: error/404.html. 이 값은 대/소문자를 구분합니다.

권한 부여

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

예제 요청 및 응답

다음 예제 URI는 myaccount라는 가상의 저장소 계정에 대해 Blob 서비스 속성을 가져오는 요청을 수행합니다.

GET https://myaccount.blob.core.windows.net/?restype=service&comp=properties&timeout=30 HTTP/1.1  

이 요청은 다음 헤더와 함께 전송되었습니다.

x-ms-version: 2018-03-28
x-ms-date: Tue, 12 Sep 2018 23:38:36 GMT
Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.blob.core.windows.net

요청이 전송된 후에는 다음과 같은 응답이 반환됩니다.

HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: application/xml
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
x-ms-version: 2018-03-28
Date: Tue, 12 Sep 2018 23:38:35 GMT  

응답에는 다음 XML 본문이 포함됩니다.

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>1.0</Version>  
        <Delete>true</Delete>  
        <Read>false</Read>  
        <Write>true</Write>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </Logging>  
    <HourMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>true</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins> http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins>  
            <AllowedMethods>GET,PUT</AllowedMethods>  
            <MaxAgeInSeconds>500</MaxAgeInSeconds>  
            <ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders>  
            <AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders>  
        </CorsRule>  
    </Cors>  
    <DefaultServiceVersion>2017-07-29</DefaultServiceVersion>
    <DeleteRetentionPolicy>
        <Enabled>true</Enabled>
        <Days>5</Days>
    </DeleteRetentionPolicy>
    <StaticWebsite>  
        <Enabled>true</Enabled>  
        <IndexDocument>index.html</IndexDocument>  
        <ErrorDocument404Path>error/404.html</ErrorDocument404Path>  
    </StaticWebsite>      
</StorageServiceProperties>    
  

참조

스토리지 분석
저장소 서비스에 대 한 CORS 지원
CORS HTTP 사양