Blob Services - Set Service Properties
Hiermee stelt u de eigenschappen in van de Blob-service van een opslagaccount, inclusief eigenschappen voor Storage Analytics en CORS-regels (Cross-Origin Resource Sharing).
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2025-06-01
URI-parameters
| Name | In | Vereist | Type | Description |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-z0-9]+$ |
De naam van het opslagaccount binnen de opgegeven resourcegroep. Namen van opslagaccounts mogen tussen de 3 en 24 tekens lang zijn en mogen alleen cijfers en kleine letters gebruiken. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
De naam van de resourcegroep. De naam is hoofdletterongevoelig. |
|
subscription
|
path | True |
string (uuid) |
De id van het doelabonnement. De waarde moet een UUID zijn. |
|
api-version
|
query | True |
string minLength: 1 |
De API-versie die voor deze bewerking moet worden gebruikt. |
Aanvraagbody
| Name | Type | Description |
|---|---|---|
| properties.automaticSnapshotPolicyEnabled |
boolean |
Afgeschaft ten gunste van de eigenschap isVersioningEnabled. |
| properties.changeFeed |
De eigenschappen van de blob-service voor wijzigingenfeed-gebeurtenissen. |
|
| properties.containerDeleteRetentionPolicy |
De eigenschappen van de Blob-service voor voorlopig verwijderen van containers. |
|
| properties.cors |
Hiermee geeft u CORS-regels voor de Blob-service op. U kunt maximaal vijf CorsRule-elementen opnemen in de aanvraag. Als er geen CorsRule-elementen zijn opgenomen in de aanvraagbody, worden alle CORS-regels verwijderd en wordt CORS uitgeschakeld voor de Blob-service. |
|
| properties.defaultServiceVersion |
string |
DefaultServiceVersion geeft de standaardversie aan die moet worden gebruikt voor aanvragen voor de Blob-service als de versie van een binnenkomende aanvraag niet is opgegeven. Mogelijke waarden zijn versie 2008-10-27 en alle recentere versies. |
| properties.deleteRetentionPolicy |
De eigenschappen van de blob-service voor voorlopig verwijderen van blobs. |
|
| properties.isVersioningEnabled |
boolean |
Versiebeheer is ingeschakeld als deze is ingesteld op true. |
| properties.lastAccessTimeTrackingPolicy |
De blob-service-eigenschap voor het configureren van het beleid voor het bijhouden van laatste toegangstijd. |
|
| properties.restorePolicy |
De eigenschappen van de blob-service voor het herstelbeleid voor blobs. |
Antwoorden
| Name | Type | Description |
|---|---|---|
| 200 OK |
De updateoperatie van de bron 'BlobServiceProperties' is geslaagd |
|
| Other Status Codes |
Een onverwachte foutreactie. |
Beveiliging
azure_auth
OAuth2-stroom voor Azure Active Directory.
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
| Name | Description |
|---|---|
| user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
|
Blob |
|
Blob |
|
Put |
BlobServicesPutAllowPermanentDelete
Voorbeeldaanvraag
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2025-06-01
{
"properties": {
"deleteRetentionPolicy": {
"allowPermanentDelete": true,
"days": 300,
"enabled": true
},
"isVersioningEnabled": true
}
}
Voorbeeldrespons
{
"name": "default",
"type": "Microsoft.Storage/storageAccounts/blobServices",
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
"properties": {
"deleteRetentionPolicy": {
"allowPermanentDelete": true,
"days": 300,
"enabled": true
},
"isVersioningEnabled": true
}
}
BlobServicesPutLastAccessTimeBasedTracking
Voorbeeldaanvraag
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2025-06-01
{
"properties": {
"lastAccessTimeTrackingPolicy": {
"name": "AccessTimeTracking",
"blobType": [
"blockBlob"
],
"enable": true,
"trackingGranularityInDays": 1
}
}
}
Voorbeeldrespons
{
"name": "default",
"type": "Microsoft.Storage/storageAccounts/blobServices",
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
"properties": {
"lastAccessTimeTrackingPolicy": {
"name": "AccessTimeTracking",
"blobType": [
"blockBlob"
],
"enable": true,
"trackingGranularityInDays": 1
}
}
}
PutBlobServices
Voorbeeldaanvraag
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2025-06-01
{
"properties": {
"changeFeed": {
"enabled": true,
"retentionInDays": 7
},
"cors": {
"corsRules": [
{
"allowedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x-ms-meta-target*"
],
"allowedMethods": [
"GET",
"HEAD",
"POST",
"OPTIONS",
"MERGE",
"PUT"
],
"allowedOrigins": [
"http://www.contoso.com",
"http://www.fabrikam.com"
],
"exposedHeaders": [
"x-ms-meta-*"
],
"maxAgeInSeconds": 100
},
{
"allowedHeaders": [
"*"
],
"allowedMethods": [
"GET"
],
"allowedOrigins": [
"*"
],
"exposedHeaders": [
"*"
],
"maxAgeInSeconds": 2
},
{
"allowedHeaders": [
"x-ms-meta-12345675754564*"
],
"allowedMethods": [
"GET",
"PUT"
],
"allowedOrigins": [
"http://www.abc23.com",
"https://www.fabrikam.com/*"
],
"exposedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x -ms-meta-target*"
],
"maxAgeInSeconds": 2000
}
]
},
"defaultServiceVersion": "2017-07-29",
"deleteRetentionPolicy": {
"days": 300,
"enabled": true
},
"isVersioningEnabled": true
}
}
Voorbeeldrespons
{
"name": "default",
"type": "Microsoft.Storage/storageAccounts/blobServices",
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
"properties": {
"changeFeed": {
"enabled": true,
"retentionInDays": 7
},
"cors": {
"corsRules": [
{
"allowedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x-ms-meta-target*"
],
"allowedMethods": [
"GET",
"HEAD",
"POST",
"OPTIONS",
"MERGE",
"PUT"
],
"allowedOrigins": [
"http://www.contoso.com",
"http://www.fabrikam.com"
],
"exposedHeaders": [
"x-ms-meta-*"
],
"maxAgeInSeconds": 100
},
{
"allowedHeaders": [
"*"
],
"allowedMethods": [
"GET"
],
"allowedOrigins": [
"*"
],
"exposedHeaders": [
"*"
],
"maxAgeInSeconds": 2
},
{
"allowedHeaders": [
"x-ms-meta-12345675754564*"
],
"allowedMethods": [
"GET",
"PUT"
],
"allowedOrigins": [
"http://www.abc23.com",
"https://www.fabrikam.com/*"
],
"exposedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x -ms-meta-target*"
],
"maxAgeInSeconds": 2000
}
]
},
"defaultServiceVersion": "2017-07-29",
"deleteRetentionPolicy": {
"days": 300,
"enabled": true
},
"isVersioningEnabled": true
},
"sku": {
"name": "Standard_GRS",
"tier": "Standard"
}
}
Definities
| Name | Description |
|---|---|
|
Allowed |
|
|
Blob |
De eigenschappen van de Blob-service van een opslagaccount. |
|
Change |
De eigenschappen van de blob-service voor wijzigingenfeed-gebeurtenissen. |
|
Cors |
Hiermee geeft u een CORS-regel voor de Blob-service. |
|
Cors |
Hiermee stelt u de CORS-regels in. U kunt maximaal vijf CorsRule-elementen opnemen in de aanvraag. |
|
Delete |
De service-eigenschappen voor voorlopig verwijderen. |
|
Error |
Een foutreactie van de opslagresourceprovider. |
|
Error |
Contract voor antwoordtekst van fout. |
|
Last |
De eigenschappen van de blob-service voor het traceringsbeleid op basis van de laatste toegangstijd. |
| Name |
Naam van het beleid. De geldige waarde is AccessTimeTracking. Dit veld is momenteel alleen-lezen |
|
Restore |
De eigenschappen van de blob-service voor het herstelbeleid voor blobs |
| Sku |
De SKU van het opslagaccount. |
|
Sku |
De SKU-naam. Vereist voor het maken van accounts; optioneel voor update. Houd er rekening mee dat in oudere versies de SKU-naam accountType is genoemd. |
|
Sku |
Het SKU-niveau. Dit is gebaseerd op de SKU-naam. |
AllowedMethods
| Waarde | Description |
|---|---|
| DELETE | |
| GET | |
| HEAD | |
| MERGE | |
| POST | |
| OPTIONS | |
| PUT | |
| PATCH | |
| CONNECT | |
| TRACE |
BlobServiceProperties
De eigenschappen van de Blob-service van een opslagaccount.
| Name | Type | Description |
|---|---|---|
| id |
string |
Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| name |
string |
De naam van de resource |
| properties.automaticSnapshotPolicyEnabled |
boolean |
Afgeschaft ten gunste van de eigenschap isVersioningEnabled. |
| properties.changeFeed |
De eigenschappen van de blob-service voor wijzigingenfeed-gebeurtenissen. |
|
| properties.containerDeleteRetentionPolicy |
De eigenschappen van de Blob-service voor voorlopig verwijderen van containers. |
|
| properties.cors |
Hiermee geeft u CORS-regels voor de Blob-service op. U kunt maximaal vijf CorsRule-elementen opnemen in de aanvraag. Als er geen CorsRule-elementen zijn opgenomen in de aanvraagbody, worden alle CORS-regels verwijderd en wordt CORS uitgeschakeld voor de Blob-service. |
|
| properties.defaultServiceVersion |
string |
DefaultServiceVersion geeft de standaardversie aan die moet worden gebruikt voor aanvragen voor de Blob-service als de versie van een binnenkomende aanvraag niet is opgegeven. Mogelijke waarden zijn versie 2008-10-27 en alle recentere versies. |
| properties.deleteRetentionPolicy |
De eigenschappen van de blob-service voor voorlopig verwijderen van blobs. |
|
| properties.isVersioningEnabled |
boolean |
Versiebeheer is ingeschakeld als deze is ingesteld op true. |
| properties.lastAccessTimeTrackingPolicy |
De blob-service-eigenschap voor het configureren van het beleid voor het bijhouden van laatste toegangstijd. |
|
| properties.restorePolicy |
De eigenschappen van de blob-service voor het herstelbeleid voor blobs. |
|
| sku |
Sku naam en niveau. |
|
| type |
string |
Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts' |
ChangeFeed
De eigenschappen van de blob-service voor wijzigingenfeed-gebeurtenissen.
| Name | Type | Description |
|---|---|---|
| enabled |
boolean |
Hiermee wordt aangegeven of logboekregistratie van wijzigingenfeeds is ingeschakeld voor de Blob-service. |
| retentionInDays |
integer (int32) minimum: 1maximum: 146000 |
Geeft de duur van de retentie van changeFeed in dagen aan. De minimumwaarde is 1 dag en de maximumwaarde is 146000 dagen (400 jaar). Een null-waarde geeft een oneindige retentie van de wijzigingenfeed aan. |
CorsRule
Hiermee geeft u een CORS-regel voor de Blob-service.
| Name | Type | Description |
|---|---|---|
| allowedHeaders |
string[] |
Vereist als het CorsRule-element aanwezig is. Een lijst met headers die deel mogen uitmaken van de cross-origin-aanvraag. |
| allowedMethods |
Vereist als het CorsRule-element aanwezig is. Een lijst met HTTP-methoden die door de oorsprong mogen worden uitgevoerd. |
|
| allowedOrigins |
string[] |
Vereist als het CorsRule-element aanwezig is. Een lijst met oorspronkelijke domeinen die worden toegestaan via CORS of *om alle domeinen toe te staan |
| exposedHeaders |
string[] |
Vereist als het CorsRule-element aanwezig is. Een lijst met antwoordheaders om beschikbaar te maken voor CORS-clients. |
| maxAgeInSeconds |
integer (int32) |
Vereist als het CorsRule-element aanwezig is. Het aantal seconden dat de client/browser een voorbereidend antwoord in de cache moet opslaan. |
CorsRules
Hiermee stelt u de CORS-regels in. U kunt maximaal vijf CorsRule-elementen opnemen in de aanvraag.
| Name | Type | Description |
|---|---|---|
| corsRules |
Cors |
De lijst met CORS-regels. U kunt maximaal vijf CorsRule-elementen opnemen in de aanvraag. |
DeleteRetentionPolicy
De service-eigenschappen voor voorlopig verwijderen.
| Name | Type | Description |
|---|---|---|
| allowPermanentDelete |
boolean |
Deze eigenschap wanneer deze is ingesteld op waar, staat het verwijderen van de voorlopig verwijderde blobversies en momentopnamen toe. Deze eigenschap kan geen blobherstelbeleid worden gebruikt. Deze eigenschap is alleen van toepassing op blobservice en is niet van toepassing op containers of bestandsshares. |
| days |
integer (int32) minimum: 1maximum: 365 |
Geeft het aantal dagen aan dat het verwijderde item moet worden bewaard. De minimaal opgegeven waarde kan 1 zijn en de maximumwaarde kan 365 zijn. |
| enabled |
boolean |
Geeft aan of DeleteRetentionPolicy is ingeschakeld. |
ErrorResponse
Een foutreactie van de opslagresourceprovider.
| Name | Type | Description |
|---|---|---|
| error |
Fouttekst van Azure Storage Resource Provider. |
ErrorResponseBody
Contract voor antwoordtekst van fout.
| Name | Type | Description |
|---|---|---|
| code |
string |
Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt. |
| message |
string |
Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface. |
LastAccessTimeTrackingPolicy
De eigenschappen van de blob-service voor het traceringsbeleid op basis van de laatste toegangstijd.
| Name | Type | Description |
|---|---|---|
| blobType |
string[] |
Een matrix met vooraf gedefinieerde ondersteunde blobtypen. Alleen blockBlob is de ondersteunde waarde. Dit veld is momenteel alleen-lezen |
| enable |
boolean |
Als deze optie is ingesteld op true last access time based tracking is enabled. |
| name |
Naam van het beleid. De geldige waarde is AccessTimeTracking. Dit veld is momenteel alleen-lezen |
|
| trackingGranularityInDays |
integer (int32) |
In het veld wordt de granulariteit voor het bijhouden van blobobjecten in dagen opgegeven, meestal hoe vaak het blobobject moet worden bijgehouden. Dit veld is momenteel alleen-lezen met de waarde 1 |
Name
Naam van het beleid. De geldige waarde is AccessTimeTracking. Dit veld is momenteel alleen-lezen
| Waarde | Description |
|---|---|
| AccessTimeTracking |
RestorePolicyProperties
De eigenschappen van de blob-service voor het herstelbeleid voor blobs
| Name | Type | Description |
|---|---|---|
| days |
integer (int32) minimum: 1maximum: 365 |
hoe lang deze blob kan worden hersteld. Het moet geweldig zijn dan nul en minder dan DeleteRetentionPolicy.days. |
| enabled |
boolean |
Blob-herstel is ingeschakeld als deze is ingesteld op waar. |
| lastEnabledTime |
string (date-time) |
Afgeschaft ten gunste van de eigenschap minRestoreTime. |
| minRestoreTime |
string (date-time) |
Geeft de minimale datum en tijd terug waarop het herstel kan worden gestart. |
Sku
De SKU van het opslagaccount.
| Name | Type | Description |
|---|---|---|
| name |
De SKU-naam. Vereist voor het maken van accounts; optioneel voor update. Houd er rekening mee dat in oudere versies de SKU-naam accountType is genoemd. |
|
| tier |
Het SKU-niveau. Dit is gebaseerd op de SKU-naam. |
SkuName
De SKU-naam. Vereist voor het maken van accounts; optioneel voor update. Houd er rekening mee dat in oudere versies de SKU-naam accountType is genoemd.
| Waarde | Description |
|---|---|
| Standard_LRS | |
| Standard_GRS | |
| Standard_RAGRS | |
| Standard_ZRS | |
| Premium_LRS | |
| Premium_ZRS | |
| Standard_GZRS | |
| Standard_RAGZRS | |
| StandardV2_LRS | |
| StandardV2_GRS | |
| StandardV2_ZRS | |
| StandardV2_GZRS | |
| PremiumV2_LRS | |
| PremiumV2_ZRS |
SkuTier
Het SKU-niveau. Dit is gebaseerd op de SKU-naam.
| Waarde | Description |
|---|---|
| Standard | |
| Premium |