Blob Hizmeti Özelliklerini Ayarlama

Makale
03/16/2023

İşlem, Set Blob Service Properties Depolama Analizi özellikleri, çıkış noktaları arası kaynak paylaşımı (CORS) kuralları ve geçici silme ayarları dahil olmak üzere depolama hesabının Blob Depolama uç noktasının özelliklerini ayarlar.

Bu işlemi, belirtilen sürüme sahip olmayan tüm gelen isteklerin varsayılan istek sürümünü Blob Depolama'ya ayarlamak için de kullanabilirsiniz.

CORS kuralları hakkında daha fazla bilgi için bkz. Azure Depolama hizmetleri için CORS desteği.

İstek

İstek Set Blob Service Properties aşağıdaki gibi belirtilebilir. HTTPS kullanmanızı öneririz. account-name değerini depolama hesabınızın adıyla değiştirin:

Yöntem	İstek URI'si	HTTP sürümü
PUT	`https://account-name.blob.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

Not

Ana bilgisayar adını URI'nin yolundan ve sorgu bölümlerinden ayırmak için URI her zaman bir eğik çizgi karakteri (/) içermelidir. Bu işlemde, URI'nin yol kısmı boş.

URI parametreleri

URI Parametresi	Description
`restype=service&comp=properties`	Gereklidir. Depolama hizmeti özelliklerini ayarlamak için her iki sorgu dizesinin birleşimi gerekir.
`timeout`	İsteğe bağlı. `timeout` parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Blob Depolama işlemleri için zaman aşımlarını ayarlama.

İstek üst bilgileri

Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştır:

İstek üst bilgisi	Açıklama
`Authorization`	Gereklidir. Yetkilendirme düzenini, depolama hesabı adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama'ya istekleri yetkilendirme.
`Date` veya `x-ms-date`	Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama'ya istekleri yetkilendirme.
`x-ms-version`	Tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
`x-ms-client-request-id`	İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibayt (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. İzleme Azure Blob Depolama.

İstek gövdesi

Sürüm 2012-02-12 ve öncesi için istek gövdesinin biçimi aşağıdaki gibidir:

<?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>  
    <!-- The DefaultServiceVersion element can only be set for Blob Storage, and the request must be made using version 2011-08-18 and later -->  
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>  
</StorageServiceProperties>

Sürüm 2013-08-15 ve üzeri için istek gövdesinin biçimi aşağıdaki gibidir:

<?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>  
    <!-- The DefaultServiceVersion element can only be set for Blob Storage, and the request must be made using version 2011-08-18 and later -->  
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>  
</StorageServiceProperties>

Sürüm 2017-07-29 ve üzeri için istek gövdesinin biçimi aşağıdaki gibidir:

<?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>

Sürüm 2018-03-28 ve üzeri için, istek gövdesinin biçimi aşağıdaki gibidir:

<?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>

Sürüm 2019-12-12 ve üzeri için istek gövdesinin biçimi aşağıdaki gibidir:

<?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>

Sürüm 2013-08-15'den itibaren, istek gövdesinde belirtilen bir veya daha fazla kök öğeyle çağırabilirsiniz Set Blob Service Properties . Kök öğeler şunlardır:

Günlüğe kaydetme
HourMetrics
MinuteMetrics
Cors
DefaultServiceVersion
DeleteRetentionPolicy: Sürüm 2017-07-29 ve üzeri
StaticWebsite: Sürüm 2018-03-28 ve üzeri

artık istek üzerindeki her kök öğeyi belirtmek gerekli değildir. Bir kök öğeyi atlarsanız, bu işlev için hizmetin mevcut ayarları korunur. Ancak, bir kök öğesi belirtirseniz, bu öğe için her alt öğeyi belirtmeniz gerekir.

Aşağıdaki tabloda istek gövdesinin öğeleri açıklanmaktadır:

Öğe adı	Açıklama
Günlüğe kaydetme	2013-08-15 sürümünden itibaren isteğe bağlı. Önceki sürümler için gereklidir. Azure Analytics Günlük ayarlarını Gruplar.
Ölçümler	Sürüm 2012-02-12 ve öncesi için gereklidir. Sürüm 2013-08-15 ve üzeri için geçerli değildir. Bloblar için saatlik toplamalar halinde API'ye göre gruplandırılan istek istatistiklerinin özetini sağlayan Azure Analytics Ölçüm ayarlarını Gruplar.
HourMetrics	2013-08-15 ve üzeri sürümler için isteğe bağlı; önceki sürümler için geçerli değildir. Bloblar için saatlik toplamalar halinde API'ye göre gruplandırılmış istek istatistiklerinin özetini sağlayan Azure Analytics HourMetrics ayarlarını Gruplar.
MinuteMetrics	2013-08-15 ve üzeri sürümler için isteğe bağlı; önceki sürümler için geçerli değildir. Bloblar için her dakika için istek istatistikleri sağlayan Azure Analytics MinuteMetrics ayarlarını Gruplar. 2013-08-15'ten önceki sürümler için MinuteMetrics yanıt gövdesine dahil değildir.
Sürüm	Günlük, Ölçümler, HourMetrics veya MinuteMetrics ayarları belirtilmişse gereklidir. Yapılandırılan Depolama Analizi sürümü.
Silme	Günlük, Ölçümler, HourMetrics veya MinuteMetrics ayarları belirtilmişse gereklidir. Yalnızca günlük yapılandırması için geçerlidir. Tüm silme isteklerinin günlüğe kaydedilip kaydedilmeyeceğini gösterir.
Read	Günlük, Ölçümler, HourMetrics veya MinuteMetrics ayarları belirtilmişse gereklidir. Yalnızca günlük yapılandırması için geçerlidir. Tüm okuma isteklerinin günlüğe kaydedilip kaydedilmeyeceğini gösterir.
Write	Günlük, Ölçümler, HourMetrics veya MinuteMetrics ayarları belirtilmişse gereklidir. Yalnızca günlük yapılandırması için geçerlidir. Tüm yazma isteklerinin günlüğe kaydedilip kaydedilmeyeceğini gösterir.
Etkin	Gereklidir. Ölçümlerin Blob Depolama için etkinleştirilip etkinleştirilmediğini gösterir. Okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiyse, hem birincil hem de ikincil ölçümler toplanır. Okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirilmediyse yalnızca birincil ölçümler toplanır.
IncludeAPI'ler	Yalnızca ölçümler etkinleştirildiğinde gereklidir. Yalnızca ölçüm yapılandırması için geçerlidir. Ölçümlerin çağrılan API işlemleri için özet istatistikleri oluşturup oluşturmayacağını gösterir.
RetentionPolicy/Etkin	Gereklidir. Depolama hizmeti için bir bekletme ilkesinin etkinleştirilip etkinleştirilmediğini gösterir.
RetentionPolicy/Gün	Yalnızca bekletme ilkesi etkinleştirildiğinde gereklidir. Ölçümlerin veya günlük verilerinin saklanması gereken gün sayısını gösterir. Bu değerden daha eski olan tüm veriler silinir. Belirtebileceğiniz en düşük değer şudur `1`: en büyük değer ( `365` bir yıl).
RetentionPolicy/AllowPermanentDelete	İsteğe bağlı, sürüm 2020-02-10 ve üzeri. Depolama hesabında kalıcı silmeyi etkinleştirmenize olanak tanır. Varsayılan değer: `false.`
DefaultServiceVersion	İsteğe bağlı. DefaultServiceVersion'ı ayarlamak için 2011-08-18 ve sonraki bir sürümü kullanarak çağırın`Set Blob Service Properties`. DefaultServiceVersion , gelen isteğin sürümü belirtilmezse Blob Depolama istekleri için kullanılacak varsayılan sürümü gösterir. Olası değerler 2008-10-27 ve sonraki sürümleri içerir. Geçerli sürümler hakkında daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma. Yalnızca Blob Depolama için geçerlidir.
Cors	İsteğe bağlı. Cors öğesi sürüm 2013-08-15 ve üzeri için desteklenir. Tüm CORS kurallarını Gruplar. Bu öğe grubunun atlanması mevcut CORS ayarlarının üzerine yazılmıyor.
CorsRule	İsteğe bağlı. Blob Depolama için bir CORS kuralı belirtir. İsteğe en fazla beş CorsRule öğesi ekleyebilirsiniz. İstek gövdesine corsrule öğesi eklenmezse, tüm CORS kuralları silinir ve Blob Depolama için CORS devre dışı bırakılır.
AllowedOrigins	CorsRule öğesi varsa gereklidir. CORS aracılığıyla izin verilen kaynak etki alanlarının virgülle ayrılmış listesi veya tüm etki alanlarına izin vermek için "*". Bir kaynak etki alanı, bir etki alanının tüm alt etki alanları için CORS aracılığıyla isteklere izin vermek için alt etki alanına joker karakter de içerebilir. 64 kaynak etki alanıyla sınırlıdır. İzin verilen her kaynak 256 karaktere kadar olabilir.
ExposedHeaders	CorsRule öğesi varsa gereklidir. CORS istemcilerinin kullanıma sunmasına yönelik yanıt üst bilgilerinin virgülle ayrılmış listesi. 64 tanımlı üst bilgi ve iki ön ekli üst bilgi ile sınırlıdır. Her üst bilgi en fazla 256 karakter olabilir.
MaxAgeInSeconds	CorsRule öğesi varsa gereklidir. İstemcinin/tarayıcının denetim öncesi yanıtını önbelleğe alması gereken saniye sayısı.
AllowedHeaders	CorsRule öğesi varsa gereklidir. Çıkış noktaları arası isteğin parçası olmasına izin verilen üst bilgilerin virgülle ayrılmış listesi. 64 tanımlı üst bilgi ve 2 ön ekli üst bilgi ile sınırlıdır. Her üst bilgi en fazla 256 karakter olabilir.
AllowedMethods	CorsRule öğesi varsa gereklidir. Kaynak tarafından yürütülmesine izin verilen HTTP yöntemlerinin virgülle ayrılmış listesi. Azure Depolama için izin verilen yöntemler DELETE, GET, HEAD, MERGE, PATCH, POST, OPTIONS ve PUT yöntemleridir.
DeleteRetentionPolicy	İsteğe bağlı. DeleteRetentionPolicy'yi ayarlamak için 2017-07-29 ve sonraki bir sürümü kullanarak çağrısında `Set Blob Service Properties` bulunur. Geçici silme ayarlarını Gruplar. Yalnızca Blob Depolama için geçerlidir.
DeleteRetentionPolicy/Enabled	Gereklidir. Silinen blob veya anlık görüntünün bir silme işlemi tarafından korunup korunmadığını veya hemen kaldırıldığını gösterir.
DeleteRetentionPolicy/Days	Yalnızca DeleteRetentionPolicy/Enabled true olduğunda gereklidir. Silinen blobun kaç gün tutulduğunu gösterir. Bu değerden daha eski olan tüm veriler kalıcı olarak silinir. Belirtebileceğiniz en düşük değer şudur `1`: en büyük değer: `365`.
StaticWebsite	İsteğe bağlı. StaticWebsite özelliklerini ayarlamak için 2018-03-28 ve sonraki bir sürümü kullanarak çağrısında `Set Blob Service Properties` bulunur. Yalnızca Blob Depolama için geçerlidir.
StaticWebsite/Enabled	Gereklidir. Belirtilen hesap için statik web sitesi desteğinin etkinleştirilip etkinleştirilmediğini gösterir.
StaticWebsite/IndexDocument	İsteğe bağlı. Azure Depolama'nın bir web sitesinin veya herhangi bir alt klasörün köküne yönelik istekler için hizmet veren web sayfası (örneğin, `index.html`). Değer büyük/küçük harfe duyarlıdır.
StaticWebsite/DefaultIndexDocumentPath	İsteğe bağlı. Azure Depolama'nın mevcut bir dosyaya karşılık etmeyen istekler için hizmet aldığı bir web sayfasının mutlak yolu. Sayfanın içeriği ile `HTTP 200 OK` döndürülür (örneğin, `index.html`). öğesi ile `StaticWebsite/IndexDocument`birbirini dışlar. Değer büyük/küçük harfe duyarlıdır.
StaticWebsite/ErrorDocument404Path	İsteğe bağlı. Azure Depolama'nın mevcut bir dosyaya karşılık etmeyen istekler için hizmet aldığı bir web sayfasının mutlak yolu. Sayfanın içeriği ile `HTTP 404 Not Found` döndürülür (örneğin, `error/404.html`). Her statik web sitesinde yalnızca tek bir özel 404 sayfası desteklenir. Değer büyük/küçük harfe duyarlıdır.

Yanıt

Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir.

Durum kodu

Başarılı bir işlem 202 (Kabul Edildi) durum kodunu döndürür.

Yanıt üst bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi	Description
`x-ms-request-id`	Hizmette yapılan bir isteği benzersiz olarak tanımlar.
`x-ms-version`	Yanıt için kullanılan işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
`x-ms-client-request-id`	İsteklerde ve karşılık gelen yanıtlarda sorun gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine `x-ms-client-request-id` eşittir. İstekte `x-ms-client-request-id` üst bilgi yoksa yanıtta bulunmaz.

Yanıt gövdesi

Yok.

Yetkilendirme

Azure Depolama'da herhangi bir veri erişim işlemi çağrılırken yetkilendirme gereklidir. İşlemi aşağıda açıklandığı gibi yetki Set Blob Service Properties verebilirsiniz.

Önemli

Microsoft, Azure Depolama'ya yönelik istekleri yetkilendirmek için yönetilen kimliklerle Microsoft Entra ID kullanılmasını önerir. Microsoft Entra ID, Paylaşılan Anahtar yetkilendirmesine kıyasla üstün güvenlik ve kullanım kolaylığı sağlar.

Azure Depolama, blob verilerine yönelik istekleri yetkilendirmek için Microsoft Entra ID kullanılmasını destekler. Microsoft Entra ID ile Azure rol tabanlı erişim denetimini (Azure RBAC) kullanarak bir güvenlik sorumlusuna izin vekleyebilirsiniz. Güvenlik sorumlusu bir kullanıcı, grup, uygulama hizmet sorumlusu veya Azure yönetilen kimliği olabilir. OAuth 2.0 belirtecini döndürmek için güvenlik sorumlusunun kimliği Microsoft Entra ID tarafından doğrulanır. Belirteç daha sonra Blob hizmetine karşı bir isteği yetkilendirmek için kullanılabilir.

Microsoft Entra ID kullanarak yetkilendirme hakkında daha fazla bilgi edinmek için bkz. Microsoft Entra ID kullanarak bloblara erişimi yetkilendirme.

İzinler

Aşağıda, Microsoft Entra kullanıcı, grup, yönetilen kimlik veya hizmet sorumlusunun işlemi çağırması Set Blob Service Properties için gereken RBAC eylemi ve bu eylemi içeren en az ayrıcalıklı yerleşik Azure RBAC rolü verilmiştir:

Azure RBAC eylemi:Microsoft.Storage/storageAccounts/blobServices/write
En az ayrıcalıklı yerleşik rol:Depolama Hesabı Katkıda Bulunanı

Azure RBAC kullanarak rol atama hakkında daha fazla bilgi edinmek için bkz. Blob verilerine erişim için Azure rolü atama.

Paylaşılan erişim imzası (SAS), depolama hesabındaki kaynaklara güvenli temsilci erişimi sağlar. SAS ile, istemcinin verilere nasıl erişebileceği üzerinde ayrıntılı denetime sahipsiniz. İstemcinin erişebileceği kaynağı, bu kaynaklara hangi izinlere sahip olduğunu ve SAS'nin ne kadar süre geçerli olduğunu belirtebilirsiniz.

İşlem, Set Blob Service Properties hesap SAS'sini kullanarak yetkilendirmeyi destekler.

Depolama hesabı için Paylaşılan Anahtar erişimine izin verilmediğinde, Blob Depolama isteğinde hesap SAS belirtecine izin verilmez. Daha fazla bilgi edinmek için bkz. Paylaşılan Anahtara izin vermenin SAS belirteçlerini nasıl etkilediğini anlama.

Hesap SAS'i

Hesap SAS'sinin güvenliği depolama hesabı anahtarıyla sağlanır. Hesap SAS ise bir veya daha fazla depolama hizmetindeki kaynaklara erişim atar. Bir hizmet veya kullanıcı temsilcisi SAS aracılığıyla kullanılabilen tüm işlemler, hesap SAS'sı aracılığıyla da kullanılabilir.

Aşağıdaki tabloda, erişim için temsilci seçme sırasında belirtilmesi gereken imzalı kaynak türü ve imzalı izinler gösterilir:

İşlem	İmzalı hizmet	İmzalı kaynak türü	İmzalı izin
Blob Hizmeti Özelliklerini Ayarlama	Blob (b)	Hizmet (ler)	Yazma (w)

Hesap SAS'i hakkında daha fazla bilgi edinmek için bkz. Hesap SAS'sini İçerik Oluşturucu.

Açıklamalar

Azure Depolama'daki CORS kuralları için aşağıdaki kısıtlamalar ve sınırlamalar geçerlidir:

En fazla beş kural depolanabilir.
İstek üzerindeki tüm CORS kuralları ayarlarının boyut üst sınırı (XML etiketleri hariç) 2 KiB'ı geçmemelidir.
İzin verilen üst bilgi, kullanıma sunulan üst bilgi veya izin verilen kaynağın uzunluğu 256 karakteri aşmamalıdır.
İzin verilen üst bilgiler ve kullanıma sunulan üst bilgiler aşağıdakilerden biri olabilir:
- x-ms-meta-processed gibi tam üst bilgi adının sağlandığı değişmez değer üst bilgileri. İstekte en fazla 64 değişmez üst bilgi belirtilebilir.
- Önekli üst bilgiler; burada x-ms-meta-data* gibi üst bilgi ön eki sağlanır. Bir ön ekin bu şekilde belirtilmesi, belirtilen ön ek ile başlayan tüm üst bilgileri sağlar veya kullanıma sunar. İstekte en fazla iki ön ekli üst bilgi belirtilebilir.
AllowedMethods öğesinde belirtilen yöntemler (veya HTTP fiilleri), Azure Depolama API'leri tarafından desteklenen yöntemlere uygun olmalıdır. Delete, GET, HEAD, MERGE, PATCH, POST, OPTIONS ve PUT yöntemleri desteklenir.

İstekte CORS kurallarının belirtilmesi isteğe bağlıdır. İstek gövdesinde Cors öğesini belirtmeden çağırırsanızSet Blob Service Properties, mevcut CORS kuralları korunur.

CORS'yi devre dışı bırakmak için boş bir CORS kuralları ayarıyla (yani</Cors>) ve iç CORS kuralları olmadan çağrısında Set Blob Service Properties bulunma. Bu çağrı mevcut kuralları siler ve Blob Depolama için CORS'yi devre dışı bırakır.

CorsRule öğesi belirtilirse tüm CORS kural öğeleri gereklidir. Herhangi bir öğe eksikse istek 400 (Bad Request) hata koduyla başarısız olur.

2013-08-15 sürümünden itibaren, XML ayarları öğeleri isteğe bağlıdır, bu nedenle yalnızca güncelleştirilmiş öğeyi içeren bir XML göndererek belirli bir öğeyi güncelleştirebilirsiniz. Diğer ayarlar etkilenmez.

CORS kuralları ve değerlendirme mantığı hakkında ayrıntılı bilgi için bkz. Azure Depolama hizmetleri için CORS desteği.

Faturalama

Fiyatlandırma istekleri, Blob Depolama API'lerini kullanan istemcilerden, doğrudan Blob Depolama REST API'si aracılığıyla veya bir Azure Depolama istemci kitaplığından kaynaklanabilir. Bu istekler işlem başına ücret tahakkuk eder. İşlem türü, hesabın ücretlendirilmeyi etkiler. Örneğin, okuma işlemleri yazma işlemlerinden farklı bir faturalama kategorisine tahakkuk eder. Aşağıdaki tabloda, depolama hesabı türüne göre istekler için Set Blob Service Properties faturalama kategorisi gösterilmektedir:

İşlem	Depolama hesabı türü	Faturalama kategorisi
Blob Hizmeti Özelliklerini Ayarlama	Premium blok blobu Standart genel amaçlı v2	Diğer işlemler
Blob Hizmeti Özelliklerini Ayarlama	Standart genel amaçlı v1	Yazma işlemleri

Belirtilen faturalama kategorisinin fiyatlandırması hakkında bilgi edinmek için bkz. fiyatlandırma Azure Blob Depolama.

Örnek istek ve yanıt

Aşağıdaki örnek URI , myaccount adlı kurgusal depolama hesabının Blob Depolama özelliklerini değiştirme isteğinde bulunur:

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

İstek aşağıdaki üst bilgilerle gönderilir:

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

İstek aşağıdaki XML gövdesiyle gönderilir:

<?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>
    <DeleteRetentionPolicy>
        <Enabled>true</Enabled>
        <Days>5</Days>
    </DeleteRetentionPolicy>  
    <StaticWebsite>  
        <Enabled>true</Enabled>  
        <IndexDocument>index.html</IndexDocument>  
        <ErrorDocument404Path>error/404.html</ErrorDocument404Path>  
    </StaticWebsite>  
    <DefaultServiceVersion>2018-03-28</DefaultServiceVersion>  
</StorageServiceProperties>

İstek gönderildikten sonra aşağıdaki yanıt döndürülür:

HTTP/1.1 202 Accepted
Transfer-Encoding: chunked
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

Ayrıca bkz.

Depolama Analizi
Azure Depolama hizmetleri için CORS desteği
CORS HTTP belirtimi

Aracılığıyla paylaş