Delen via


Eigenschappen van blobservice instellen

Met Set Blob Service Properties de bewerking worden eigenschappen ingesteld voor het Blob Storage-eindpunt van een opslagaccount, waaronder eigenschappen voor Opslaganalyse, CORS-regels (Cross-Origin Resource Sharing) en instellingen voor voorlopig verwijderen.

U kunt deze bewerking ook gebruiken om de standaardaanvraagversie in te stellen voor alle binnenkomende aanvragen voor Blob Storage die geen opgegeven versie hebben.

Zie CORS-ondersteuning voor de Azure Storage-services voor meer informatie over CORS-regels.

Aanvraag

De Set Blob Service Properties aanvraag kan als volgt worden opgegeven. U wordt aangeraden HTTPS te gebruiken. Vervang accountnaam door de naam van uw opslagaccount:

Methode Aanvraag-URI HTTP-versie
PUT https://account-name.blob.core.windows.net/?restype=service&comp=properties HTTP/1.1

Notitie

De URI moet altijd een slash (/) bevatten om de hostnaam te scheiden van het pad en de querygedeelten van de URI. In deze bewerking is het padgedeelte van de URI leeg.

URI-parameters

URI-parameter Description
restype=service&comp=properties Vereist. De combinatie van beide queryreeksen is vereist om de eigenschappen van de opslagservice in te stellen.
timeout Optioneel. De timeout parameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor Blob Storage-bewerkingen voor meer informatie.

Aanvraagheaders

De vereiste en optionele aanvraagheaders worden beschreven in de volgende tabel:

Aanvraagheader Beschrijving
Authorization Vereist. Hiermee geeft u het autorisatieschema, de naam van het opslagaccount en de handtekening op. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie.
Date of x-ms-date Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie.
x-ms-version Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
x-ms-client-request-id Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Azure Blob Storage bewaken voor meer informatie.

Aanvraagbody

Voor versie 2012-02-12 en eerder is de indeling van de aanvraagbody als volgt:

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

Voor versie 2013-08-15 en hoger is de indeling van de aanvraagbody als volgt:

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

Voor versie 29-07-2017 en hoger is de indeling van de aanvraagbody als volgt:

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

Voor versie 28-03-28 en hoger is de indeling van de aanvraagbody als volgt:

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

Voor versie 2019-12-12 en hoger is de indeling van de aanvraagbody als volgt:

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

Vanaf versie 2013-08-15 kunt u aanroepen Set Blob Service Properties met een of meer hoofdelementen die zijn opgegeven in de hoofdtekst van de aanvraag. De hoofdelementen zijn onder andere:

  • Logboekregistratie
  • HourMetrics
  • MinuteMetrics
  • Cors
  • DefaultServiceVersion
  • DeleteRetentionPolicy: versie 29-07-2017 en hoger
  • StaticWebsite: Versie 28-03-28 en hoger

Het is niet langer nodig om elk hoofdelement in de aanvraag op te geven. Als u een hoofdelement weglaat, blijven de bestaande instellingen voor de service voor die functionaliteit behouden. Als u echter een hoofdelement opgeeft, moet u elk onderliggend element voor dat element opgeven.

In de volgende tabel worden de elementen van de aanvraagbody beschreven:

Elementnaam Beschrijving
Logboekregistratie Optioneel vanaf versie 2013-08-15. Vereist voor eerdere versies. Groepen de instellingen voor logboekregistratie van Azure Analytics.
Metrische gegevens Vereist voor versie 2012-02-12 en eerder. Niet van toepassing op versie 2013-08-15 en hoger. Groepen de instellingen voor metrische gegevens van Azure Analytics, die een overzicht bieden van aanvraagstatistieken die per API zijn gegroepeerd in aggregaties per uur voor blobs.
HourMetrics Optioneel voor versie 2013-08-15 en hoger; niet van toepassing op eerdere versies. Groepen de Azure Analytics HourMetrics-instellingen, die een overzicht bieden van aanvraagstatistieken gegroepeerd per API in aggregaties per uur voor blobs.
MinuteMetrics Optioneel voor versie 2013-08-15 en hoger; niet van toepassing op eerdere versies. Groepen de Azure Analytics MinuteMetrics-instellingen, die aanvraagstatistieken bieden voor elke minuut voor blobs. Voor versies ouder dan 2013-08-15 is MinuteMetrics niet opgenomen in de antwoordtekst.
Versie Vereist als de instellingen Logboekregistratie, Metrische gegevens, HourMetrics of MinuteMetrics zijn opgegeven. De versie van Opslaganalyse die u wilt configureren.
Verwijderen Vereist als de instellingen Logboekregistratie, Metrische gegevens, HourMetrics of MinuteMetrics zijn opgegeven. Is alleen van toepassing op de configuratie van logboekregistratie. Hiermee wordt aangegeven of alle verwijderingsaanvragen moeten worden geregistreerd.
Lezen Vereist als de instellingen Logboekregistratie, Metrische gegevens, HourMetrics of MinuteMetrics zijn opgegeven. Is alleen van toepassing op de configuratie van logboekregistratie. Hiermee wordt aangegeven of alle leesaanvragen moeten worden geregistreerd.
Schrijven Vereist als de instellingen Logboekregistratie, Metrische gegevens, HourMetrics of MinuteMetrics zijn opgegeven. Is alleen van toepassing op de configuratie van logboekregistratie. Hiermee wordt aangegeven of alle schrijfaanvragen moeten worden geregistreerd.
Ingeschakeld Vereist. Hiermee wordt aangegeven of metrische gegevens zijn ingeschakeld voor Blob Storage.

Als geografisch redundante replicatie met leestoegang is ingeschakeld, worden zowel primaire als secundaire metrische gegevens verzameld. Als geografisch redundante replicatie met leestoegang niet is ingeschakeld, worden alleen primaire metrische gegevens verzameld.
IncludeAPIs Alleen vereist als metrische gegevens zijn ingeschakeld. Is alleen van toepassing op de configuratie van metrische gegevens. Geeft aan of metrische gegevens samenvattingsstatistieken moeten genereren voor aangeroepen API-bewerkingen.
RetentionPolicy/Ingeschakeld Vereist. Geeft aan of een bewaarbeleid is ingeschakeld voor de opslagservice.
RetentionPolicy/dagen Alleen vereist als een bewaarbeleid is ingeschakeld. Geeft het aantal dagen aan dat metrische gegevens of logboekgegevens moeten worden bewaard. Alle gegevens die ouder zijn dan deze waarde, worden verwijderd. De minimale waarde die u kunt opgeven is 1; de grootste waarde is 365 (één jaar).
RetentionPolicy/AllowPermanentDelete Optioneel, versie 2020-02-10 en hoger. Hiermee kunt u permanent verwijderen inschakelen voor het opslagaccount. De standaardwaarde is false.
DefaultServiceVersion Optioneel. Als u DefaultServiceVersion wilt instellen, roept u Set Blob Service Properties aan met versie 2011-08-18 en hoger. DefaultServiceVersion geeft de standaardversie aan die moet worden gebruikt voor aanvragen naar Blob Storage als de versie van een binnenkomende aanvraag niet is opgegeven. Mogelijke waarden zijn versie 2008-10-27 en hoger. Zie Versiebeheer voor de Azure Storage-services voor meer informatie over toepasselijke versies.

Alleen van toepassing op Blob Storage.
Cors Optioneel. Het Element Cors wordt ondersteund voor versie 2013-08-15 en hoger. Groepen alle CORS-regels.

Als u deze elementgroep weglaat, worden bestaande CORS-instellingen niet overschreven.
CorsRule Optioneel. Hiermee geeft u een CORS-regel voor Blob Storage. U kunt maximaal vijf CorsRule-elementen in de aanvraag opnemen. Als er geen CorsRule-elementen zijn opgenomen in de aanvraagbody, worden alle CORS-regels verwijderd en wordt CORS uitgeschakeld voor Blob Storage.
AllowedOrigins Vereist als het element CorsRule aanwezig is. Een door komma's gescheiden lijst met oorsprongsdomeinen die zijn toegestaan via CORS, of '*' om alle domeinen toe te staan. Een oorspronkelijk domein kan ook een jokerteken bevatten in het subdomein om aanvragen via CORS toe te laten voor alle subdomeinen van een domein. Beperkt tot 64 oorsprongsdomeinen. Elke toegestane oorsprong mag maximaal 256 tekens bevatten.
ExposedHeaders Vereist als het element CorsRule aanwezig is. Een door komma's gescheiden lijst met antwoordheaders om beschikbaar te maken voor CORS-clients. Beperkt tot 64 gedefinieerde headers en twee kopteksten met voorvoegsel. Elke koptekst mag maximaal 256 tekens bevatten.
MaxAgeInSeconds Vereist als het element CorsRule aanwezig is. Het aantal seconden dat de client/browser een voorbereidend antwoord in de cache moet opslaan.
AllowedHeaders Vereist als het element CorsRule bestaat. Een door komma's gescheiden lijst met kopteksten die deel mogen uitmaken van de cross-origin-aanvraag. Beperkt tot 64 gedefinieerde headers en 2 kopteksten met voorvoegsel. Elke koptekst mag maximaal 256 tekens bevatten.
AllowedMethods Vereist als het element CorsRule bestaat. Een door komma's gescheiden lijst met HTTP-methoden die door de oorsprong mogen worden uitgevoerd. Voor Azure Storage zijn toegestane methoden DELETE, GET, HEAD, MERGE, PATCH, POST, OPTIONS en PUT.
DeleteRetentionPolicy Optioneel. Als u DeleteRetentionPolicy wilt instellen, roept Set Blob Service Properties u aan met versie 2017-07-29 en hoger. Groepen de instellingen voor voorlopig verwijderen. Alleen van toepassing op Blob Storage.
DeleteRetentionPolicy/Enabled Vereist. Geeft aan of de verwijderde blob of momentopname wordt bewaard of onmiddellijk wordt verwijderd door een verwijderbewerking.
DeleteRetentionPolicy/Dagen Alleen vereist als DeleteRetentionPolicy/Enabled waar is. Geeft het aantal dagen aan dat verwijderde blob moet worden bewaard. Alle gegevens die ouder zijn dan deze waarde, worden definitief verwijderd. De minimale waarde die u kunt opgeven is 1; de grootste waarde is 365.
StaticWebsite Optioneel. Als u eigenschappen van StaticWebsite wilt instellen, roept u Set Blob Service Properties aan met versie 28-03-28 en hoger. Alleen van toepassing op Blob Storage.
StaticWebsite/Enabled Vereist. Geeft aan of ondersteuning voor statische websites is ingeschakeld voor het opgegeven account.
StaticWebsite/IndexDocument Optioneel. De webpagina die Azure Storage gebruikt voor aanvragen naar de hoofdmap van een website of een submap (bijvoorbeeld index.html). De waarde is hoofdlettergevoelig.
StaticWebsite/DefaultIndexDocumentPath Optioneel. Het absolute pad naar een webpagina die Door Azure Storage wordt gebruikt voor aanvragen die niet overeenkomen met een bestaand bestand. De inhoud van de pagina wordt geretourneerd met HTTP 200 OK (bijvoorbeeld index.html). Het -element is wederzijds exclusief met StaticWebsite/IndexDocument. De waarde is hoofdlettergevoelig.
StaticWebsite/ErrorDocument404Path Optioneel. Het absolute pad naar een webpagina die Door Azure Storage wordt gebruikt voor aanvragen die niet overeenkomen met een bestaand bestand. De inhoud van de pagina wordt geretourneerd met HTTP 404 Not Found (bijvoorbeeld error/404.html). Op elke statische website wordt slechts één aangepaste 404-pagina ondersteund. De waarde is hoofdlettergevoelig.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Statuscode

Een geslaagde bewerking retourneert statuscode 202 (Geaccepteerd).

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook extra standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Antwoordheader Description
x-ms-request-id Identificeert op unieke wijze een aanvraag die is ingediend tegen de service.
x-ms-version Hiermee geeft u de versie van de bewerking die wordt gebruikt voor het antwoord. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
x-ms-client-request-id Kan worden gebruikt om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id header als deze aanwezig is in de aanvraag en de waarde niet meer dan 1024 zichtbare ASCII-tekens bevat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze niet aanwezig in het antwoord.

Hoofdtekst van de reactie

Geen.

Autorisatie

Autorisatie is vereist bij het aanroepen van een bewerking voor gegevenstoegang in Azure Storage. U kunt de Set Blob Service Properties bewerking autoriseren zoals hieronder wordt beschreven.

Belangrijk

Microsoft raadt aan Microsoft Entra ID met beheerde identiteiten te gebruiken om aanvragen voor Azure Storage te autoriseren. Microsoft Entra ID biedt superieure beveiliging en gebruiksgemak in vergelijking met autorisatie van gedeelde sleutels.

Azure Storage ondersteunt het gebruik van Microsoft Entra ID om aanvragen voor blobgegevens te autoriseren. Met Microsoft Entra ID kunt u op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC) gebruiken om machtigingen te verlenen aan een beveiligingsprincipal. De beveiligingsprincipal kan een gebruiker, groep, toepassingsservice-principal of door Azure beheerde identiteit zijn. De beveiligingsprincipal wordt geverifieerd door Microsoft Entra ID om een OAuth 2.0-token te retourneren. Het token kan vervolgens worden gebruikt om een aanvraag voor de Blob-service te autoriseren.

Zie Toegang tot blobs autoriseren met behulp van Microsoft Entra ID voor meer informatie over autorisatie met behulp van Microsoft Entra ID.

Machtigingen

Hieronder vindt u de RBAC-actie die nodig is voor een Microsoft Entra gebruiker, groep, beheerde identiteit of service-principal om de Set Blob Service Properties bewerking aan te roepen, en de ingebouwde Azure RBAC-rol met de minste bevoegdheden die deze actie omvat:

Zie Een Azure-rol toewijzen voor toegang tot blobgegevens voor meer informatie over het toewijzen van rollen met behulp van Azure RBAC.

Opmerkingen

De volgende beperkingen zijn van toepassing op CORS-regels in Azure Storage:

  • Er kunnen maximaal vijf regels worden opgeslagen.

  • De maximale grootte van alle CORS-regels voor de aanvraag, met uitzondering van XML-tags, mag niet groter zijn dan 2 KiB.

  • De lengte van een toegestane koptekst, weergegeven koptekst of toegestane oorsprong mag niet langer zijn dan 256 tekens.

  • Toegestane headers en weergegeven headers kunnen zijn:

    • Letterlijke headers, waarbij de exacte headernaam wordt opgegeven, zoals x-ms-meta-verwerkt. Er kunnen maximaal 64 letterlijke headers worden opgegeven voor de aanvraag.

    • Kopteksten met voorvoegsel, waarbij een voorvoegsel van de header is opgegeven, zoals x-ms-meta-data*. Als u op deze manier een voorvoegsel opgeeft, wordt elke koptekst die begint met het opgegeven voorvoegsel, toegestaan of weergegeven. Er kunnen maximaal twee kopteksten met voorvoegsel worden opgegeven voor de aanvraag.

  • De methoden (of HTTP-werkwoorden) die zijn opgegeven in het element AllowedMethods moeten voldoen aan de methoden die worden ondersteund door de Azure Storage-API's. Ondersteunde methoden zijn DELETE, GET, HEAD, MERGE, PATCH, POST, OPTIONS en PUT.

Het opgeven van CORS-regels voor de aanvraag is optioneel. Als u aanroept Set Blob Service Properties zonder het Cors-element in de aanvraagbody op te geven, blijven alle bestaande CORS-regels behouden.

Als u CORS wilt uitschakelen, roept Set Blob Service Properties u aan met een lege CORS-regelinstelling (dat wil gezegd</Cors>) en geen interne CORS-regels. Met deze aanroep worden alle bestaande regels verwijderd en CORS voor Blob Storage uitgeschakeld.

Alle CORS-regelelementen zijn vereist als het element CorsRule is opgegeven. De aanvraag mislukt met foutcode 400 (Bad Request) als er een element ontbreekt.

Vanaf versie 2013-08-15 zijn XML-instellingen optioneel, zodat u een specifiek element kunt bijwerken door een XML te verzenden die alleen het bijgewerkte element bevat. Andere instellingen worden niet beïnvloed.

Zie CORS-ondersteuning voor de Azure Storage-services voor gedetailleerde informatie over CORS-regels en evaluatielogica.

Billing

Prijsaanvragen kunnen afkomstig zijn van clients die gebruikmaken van Blob Storage-API's, rechtstreeks via de Blob Storage REST API of vanuit een Azure Storage-clientbibliotheek. Met deze aanvragen worden kosten per transactie in rekening gebracht. Het type transactie is van invloed op de manier waarop de rekening in rekening wordt gebracht. Leestransacties worden bijvoorbeeld toegevoegd aan een andere factureringscategorie dan schrijftransacties. In de volgende tabel ziet u de factureringscategorie voor Set Blob Service Properties aanvragen op basis van het type opslagaccount:

Bewerking Type opslagaccount Factureringscategorie
Blob-service-eigenschappen instellen Premium-blok-blob
Standard v2 voor algemeen gebruik
Andere bewerkingen
Blob-service-eigenschappen instellen Standard v1 voor algemeen gebruik Schrijfbewerkingen

Zie prijzen voor Azure Blob Storage voor meer informatie over prijzen voor de opgegeven factureringscategorie.

Voorbeeld van aanvraag en antwoord

De volgende voorbeeld-URI doet een aanvraag voor het wijzigen van Blob Storage-eigenschappen voor het fictieve opslagaccount met de naam myaccount:

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

De aanvraag wordt verzonden met de volgende headers:

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  

De aanvraag wordt verzonden met de volgende XML-hoofdtekst:

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

Nadat de aanvraag is verzonden, wordt het volgende antwoord geretourneerd:

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
  

Zie ook

Storage Analytics
CORS-ondersteuning voor de Azure Storage-services
CORS HTTP-specificatie