Eigenschappen van blobservice ophalen
De Get Blob Service Properties
bewerking haalt de eigenschappen van een Azure Blob Storage-account op, inclusief eigenschappen voor Opslaganalyse en CORS-regels (Cross-Origin Resource Sharing).
Aanvraag
U kunt de Get Blob Service Properties
aanvraag als volgt opgeven. U wordt aangeraden HTTPS te gebruiken. Vervang door <account-name>
de naam van uw opslagaccount:
Methode | Aanvraag-URI | HTTP-versie |
---|---|---|
GET | 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. In het geval van 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 blobopslageigenschappen op te halen. |
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 voor Azure Storage autoriseren voor meer informatie. |
Date of x-ms-date |
Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen voor Azure Storage autoriseren 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
Geen.
Antwoord
Het antwoord bevat een HTTP-statuscode, een set antwoordheaders en een antwoordtekst.
Statuscode
Een geslaagde bewerking retourneert statuscode 200 (OK).
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 header niet aanwezig in het antwoord. |
Hoofdtekst van de reactie
Voor versie 2012-02-12 en eerder is de indeling van de antwoordtekst 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>
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
</StorageServiceProperties>
Vanaf versie 2013-08-15 is de indeling van de antwoordtekst 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>
</StorageServiceProperties>
Vanaf versie 2017-07-29 is de indeling van de antwoordtekst 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>
Vanaf versie 28-03-2018 is de indeling van de antwoordtekst 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>
Vanaf versie 2019-12-12 is de indeling van de antwoordtekst 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>
De elementen van de antwoordtekst worden beschreven in de volgende tabel:
Elementnaam | Beschrijving |
---|---|
Logboekregistratie | Groepen de azure Analytics-instellingen voor logboekregistratie. |
Metrische gegevens | Groepen de instellingen voor metrische gegevens van Azure Analytics. De instellingen voor metrische gegevens bieden een samenvatting van aanvraagstatistieken, gegroepeerd per API in aggregaties per uur voor blobs. |
HourMetrics | Groepen de instellingen van Azure Analytics HourMetrics. De instellingen van HourMetrics bieden een overzicht van aanvraagstatistieken, gegroepeerd per API in aggregaties per uur voor blobs. |
MinuteMetrics | Groepen de instellingen voor Azure Analytics MinuteMetrics. De minutemetrics-instellingen bieden aanvraagstatistieken voor elke minuut voor blobs. |
Versie | De versie van Opslaganalyse momenteel in gebruik. |
Verwijderen | Alleen van toepassing op logboekconfiguratie. Hiermee wordt aangegeven of verwijderingsaanvragen worden geregistreerd. |
Lezen | Alleen van toepassing op logboekconfiguratie. Hiermee wordt aangegeven of leesaanvragen worden geregistreerd. |
Schrijven | Alleen van toepassing op logboekconfiguratie. Hiermee wordt aangegeven of schrijfaanvragen worden geregistreerd. |
Ingeschakeld | Geeft aan 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 | Is alleen van toepassing op de configuratie van metrische gegevens. Geeft aan of metrische gegevens samenvattingsstatistieken genereren voor aangeroepen API-bewerkingen. |
RetentionPolicy/Ingeschakeld | Hiermee wordt aangegeven of een bewaarbeleid is ingeschakeld voor De Azure Storage. |
RetentionPolicy/dagen | Geeft het aantal dagen aan dat metrische gegevens of logboekgegevens worden bewaard. Alle gegevens die ouder zijn dan deze waarde, worden verwijderd. |
DefaultServiceVersion | Geeft de standaardversie aan die moet worden gebruikt voor aanvragen naar Blob Storage als de versie van een binnenkomende aanvraag niet is opgegeven. Waarden zijn onder andere versie 2008-10-27 en hoger. Zie Versiebeheer voor de Azure Storage-services voor meer informatie over toepasselijke versies. |
Cors | Groepen alle CORS-regels. |
CorsRule | Groepen instellingen voor een CORS-regel. |
AllowedOrigins | Een door komma's gescheiden lijst met oorsprongsdomeinen die zijn toegestaan via CORS, of '*' als alle domeinen zijn toegestaan. |
ExposedHeaders | Een door komma's gescheiden lijst met antwoordheaders om beschikbaar te maken voor CORS-clients. |
MaxAgeInSeconds | Het aantal seconden dat de client/browser een voorbereidend antwoord in de cache moet opslaan. |
AllowedHeaders | Een door komma's gescheiden lijst met headers die deel mogen uitmaken van de cross-origin-aanvraag. |
AllowedMethods | Een door komma's gescheiden lijst met HTTP-methoden die door de oorsprong mogen worden uitgevoerd. Voor Azure Storage zijn de toegestane methoden DELETE, GET, HEAD, MERGE, POST, OPTIONS en PUT. |
DeleteRetentionPolicy | Groepen de Azure Delete-instellingen. Alleen van toepassing op Blob Storage. |
Ingeschakeld | Hiermee wordt aangegeven of een verwijderde blob of momentopname wordt bewaard of onmiddellijk wordt verwijderd door de verwijderbewerking. |
Dagen | Geeft het aantal dagen aan dat een verwijderde blob moet worden bewaard. Alle gegevens die ouder zijn dan deze waarde, worden definitief verwijderd. |
StaticWebsite | Groepen de statischewebsite-instellingen. Alleen van toepassing op Blob Storage. |
StaticWebsite/Enabled | Hiermee wordt aangegeven of ondersteuning voor statische websites is ingeschakeld voor het opgegeven account. |
StaticWebsite/IndexDocument | 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 | 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 | 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 ). De waarde is hoofdlettergevoelig. |
Autorisatie
Autorisatie is vereist bij het aanroepen van een bewerking voor gegevenstoegang in Azure Storage. U kunt de Get 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 Get Blob Service Properties
bewerking aan te roepen, en de ingebouwde Azure RBAC-rol met de minste bevoegdheden die deze actie omvat:
- Azure RBAC-actie:Microsoft.Storage/storageAccounts/blobServices/read
- Ingebouwde rol met minimale bevoegdheden:Inzender opslagaccount
Zie Een Azure-rol toewijzen voor toegang tot blobgegevens voor meer informatie over het toewijzen van rollen met behulp van Azure RBAC.
Opmerkingen
Geen. Zie factureringsgegevens voor meer informatie over hoe deze bewerking van invloed is op de kosten.
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 Get Blob Service Properties
aanvragen op basis van het type opslagaccount:
Bewerking | Type opslagaccount | Factureringscategorie |
---|---|---|
Eigenschappen van blobservice ophalen | Premium blok-blob Standaard v2 voor algemeen gebruik |
Andere bewerkingen |
Eigenschappen van blobservice ophalen | Standaard v1 voor algemeen gebruik | Leesbewerkingen |
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 ophalen van Blob Storage-eigenschappen voor een fictief opslagaccount met de naam myaccount:
GET https://myaccount.blob.core.windows.net/?restype=service&comp=properties&timeout=30 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:36 GMT
Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=
Host: myaccount.blob.core.windows.net
Nadat de aanvraag is verzonden, wordt het volgende antwoord geretourneerd:
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
Het antwoord bevat 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>
<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>
Zie ook
Storage Analytics
CORS-ondersteuning voor de Azure Storage-services
CORS HTTP-specificatie