Blob Services - Set Service Properties
Legt die Eigenschaften des Blob-Diensts eines Speicherkontos fest, einschließlich Eigenschaften für Storage Analytics und CORS-Regeln (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-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-z0-9]+$ |
Der Name des Speicherkontos innerhalb der angegebenen Ressourcengruppe. Speicherkontonamen müssen zwischen 3 und 24 Zeichen lang sein und dürfen nur Zahlen und Kleinbuchstaben enthalten. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
|
subscription
|
path | True |
string (uuid) |
Die ID des Zielabonnements. Der Wert muss eine UUID sein. |
|
api-version
|
query | True |
string minLength: 1 |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
Anforderungstext
| Name | Typ | Beschreibung |
|---|---|---|
| properties.automaticSnapshotPolicyEnabled |
boolean |
Veraltet für isVersioningEnabled-Eigenschaft. |
| properties.changeFeed |
Die Blobdiensteigenschaften für Änderungsfeedereignisse. |
|
| properties.containerDeleteRetentionPolicy |
Die Blob-Diensteigenschaften für das vorläufige Löschen von Containern. |
|
| properties.cors |
Gibt CORS-Regeln für den BLOB-Dienst an. Sie können bis zu fünf CorsRule-Elemente in die Anforderung aufnehmen. Wenn keine CorsRule-Elemente im Anforderungstext enthalten sind, werden alle CORS-Regeln gelöscht, und CORS wird für den Blob-Dienst deaktiviert. |
|
| properties.defaultServiceVersion |
string |
DefaultServiceVersion gibt die Standardversion an, die für Anforderungen an den Blob-Dienst verwendet werden soll, wenn die Version einer eingehenden Anforderung nicht angegeben ist. Mögliche Werte sind Version 2008-10-27 und alle neueren Versionen. |
| properties.deleteRetentionPolicy |
Die Blobdiensteigenschaften für das vorläufige Löschen von Blobs. |
|
| properties.isVersioningEnabled |
boolean |
Die Versionsverwaltung ist aktiviert, wenn sie auf "true" festgelegt ist. |
| properties.lastAccessTimeTrackingPolicy |
Die BLOB-Diensteigenschaft zum Konfigurieren der Richtlinie für die nach der letzten Zugriffszeit basierende Nachverfolgung. |
|
| properties.restorePolicy |
Die Blobdiensteigenschaften für die Blobwiederherstellungsrichtlinie. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Die Aktualisierungsoperation der Ressource 'BlobServiceProperties' war erfolgreich |
|
| Other Status Codes |
Unerwartete Fehlerantwort. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Fluss.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
|
Blob |
|
Blob |
|
Put |
BlobServicesPutAllowPermanentDelete
Beispielanforderung
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
}
}
Beispiel für eine Antwort
{
"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
Beispielanforderung
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
}
}
}
Beispiel für eine Antwort
{
"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
Beispielanforderung
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
}
}
Beispiel für eine Antwort
{
"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"
}
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Allowed |
|
|
Blob |
Die Eigenschaften des BLOB-Diensts eines Speicherkontos. |
|
Change |
Die Blobdiensteigenschaften für Änderungsfeedereignisse. |
|
Cors |
Gibt eine CORS-Regel für den Blob-Dienst an. |
|
Cors |
Legt die CORS-Regeln fest. Sie können bis zu fünf CorsRule-Elemente in die Anforderung aufnehmen. |
|
Delete |
Die Diensteigenschaften für das vorläufige Löschen. |
|
Error |
Eine Fehlerantwort des Speicherressourcenanbieters. |
|
Error |
Fehlerantworttext-Vertrag. |
|
Last |
Die Blob-Diensteigenschaften für die Richtlinie für die nach der letzten Zugriffszeit basierende Nachverfolgung. |
| Name |
Name der Richtlinie. Der gültige Wert ist AccessTimeTracking. Dieses Feld ist zurzeit schreibgeschützt. |
|
Restore |
Die Blobdiensteigenschaften für blob-Wiederherstellungsrichtlinie |
| Sku |
Die SKU des Speicherkontos. |
|
Sku |
Der SKU-Name. Erforderlich für die Kontoerstellung; optional für Update. Beachten Sie, dass in älteren Versionen der SKU-Name "accountType" genannt wurde. |
|
Sku |
Die SKU-Ebene. Dies basiert auf dem SKU-Namen. |
AllowedMethods
| Wert | Beschreibung |
|---|---|
| DELETE | |
| GET | |
| HEAD | |
| MERGE | |
| POST | |
| OPTIONS | |
| PUT | |
| PATCH | |
| CONNECT | |
| TRACE |
BlobServiceProperties
Die Eigenschaften des BLOB-Diensts eines Speicherkontos.
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Zum Beispiel - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| name |
string |
Der Name der Ressource |
| properties.automaticSnapshotPolicyEnabled |
boolean |
Veraltet für isVersioningEnabled-Eigenschaft. |
| properties.changeFeed |
Die Blobdiensteigenschaften für Änderungsfeedereignisse. |
|
| properties.containerDeleteRetentionPolicy |
Die Blob-Diensteigenschaften für das vorläufige Löschen von Containern. |
|
| properties.cors |
Gibt CORS-Regeln für den BLOB-Dienst an. Sie können bis zu fünf CorsRule-Elemente in die Anforderung aufnehmen. Wenn keine CorsRule-Elemente im Anforderungstext enthalten sind, werden alle CORS-Regeln gelöscht, und CORS wird für den Blob-Dienst deaktiviert. |
|
| properties.defaultServiceVersion |
string |
DefaultServiceVersion gibt die Standardversion an, die für Anforderungen an den Blob-Dienst verwendet werden soll, wenn die Version einer eingehenden Anforderung nicht angegeben ist. Mögliche Werte sind Version 2008-10-27 und alle neueren Versionen. |
| properties.deleteRetentionPolicy |
Die Blobdiensteigenschaften für das vorläufige Löschen von Blobs. |
|
| properties.isVersioningEnabled |
boolean |
Die Versionsverwaltung ist aktiviert, wenn sie auf "true" festgelegt ist. |
| properties.lastAccessTimeTrackingPolicy |
Die BLOB-Diensteigenschaft zum Konfigurieren der Richtlinie für die nach der letzten Zugriffszeit basierende Nachverfolgung. |
|
| properties.restorePolicy |
Die Blobdiensteigenschaften für die Blobwiederherstellungsrichtlinie. |
|
| sku |
SKU-Name und -Stufe. |
|
| type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
ChangeFeed
Die Blobdiensteigenschaften für Änderungsfeedereignisse.
| Name | Typ | Beschreibung |
|---|---|---|
| enabled |
boolean |
Gibt an, ob die Ereignisprotokollierung des Änderungsfeeds für den Blob-Dienst aktiviert ist. |
| retentionInDays |
integer (int32) minimum: 1maximum: 146000 |
Gibt die Dauer der ChangeFeed-Aufbewahrung in Tagen an. Der Mindestwert beträgt 1 Tag und der Maximalwert beträgt 146000 Tage (400 Jahre). Ein Nullwert gibt eine unendliche Aufbewahrung des Änderungsfeeds an. |
CorsRule
Gibt eine CORS-Regel für den Blob-Dienst an.
| Name | Typ | Beschreibung |
|---|---|---|
| allowedHeaders |
string[] |
Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der Kopfzeilen, die Teil der ursprungsübergreifenden Anforderung sein dürfen. |
| allowedMethods |
Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen. |
|
| allowedOrigins |
string[] |
Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der Ursprungsdomänen, die über CORS zulässig sind, oder "*", um alle Domänen zuzulassen |
| exposedHeaders |
string[] |
Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der Antwortheader, die CORS-Clients zur Verfügung stellen sollen. |
| maxAgeInSeconds |
integer (int32) |
Erforderlich, wenn corsRule-Element vorhanden ist. Die Anzahl der Sekunden, für die der Client/Browser eine Preflight-Antwort zwischenspeichern soll. |
CorsRules
Legt die CORS-Regeln fest. Sie können bis zu fünf CorsRule-Elemente in die Anforderung aufnehmen.
| Name | Typ | Beschreibung |
|---|---|---|
| corsRules |
Cors |
Die Liste der CORS-Regeln. Sie können bis zu fünf CorsRule-Elemente in die Anforderung aufnehmen. |
DeleteRetentionPolicy
Die Diensteigenschaften für das vorläufige Löschen.
| Name | Typ | Beschreibung |
|---|---|---|
| allowPermanentDelete |
boolean |
Diese Eigenschaft, wenn sie auf "true" festgelegt ist, ermöglicht das Löschen der vorläufig gelöschten BLOB-Versionen und Momentaufnahmen. Diese Eigenschaft kann keine Blob-Wiederherstellungsrichtlinie verwenden. Diese Eigenschaft gilt nur für blob-Dienst und gilt nicht für Container oder Dateifreigaben. |
| days |
integer (int32) minimum: 1maximum: 365 |
Gibt die Anzahl der Tage an, die das gelöschte Element beibehalten werden soll. Der angegebene Mindestwert kann 1 sein, und der Maximalwert kann 365 sein. |
| enabled |
boolean |
Gibt an, ob DeleteRetentionPolicy aktiviert ist. |
ErrorResponse
Eine Fehlerantwort des Speicherressourcenanbieters.
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Fehlerantworttext des Azure Storage-Ressourcenanbieters. |
ErrorResponseBody
Fehlerantworttext-Vertrag.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden. |
| message |
string |
Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist. |
LastAccessTimeTrackingPolicy
Die Blob-Diensteigenschaften für die Richtlinie für die nach der letzten Zugriffszeit basierende Nachverfolgung.
| Name | Typ | Beschreibung |
|---|---|---|
| blobType |
string[] |
Ein Array vordefinierter unterstützter BLOB-Typen. Nur blockBlob ist der unterstützte Wert. Dieses Feld ist zurzeit schreibgeschützt. |
| enable |
boolean |
Wenn der Wert auf "True" festgelegt ist, wird die zeitbasierte Nachverfolgung aktiviert. |
| name |
Name der Richtlinie. Der gültige Wert ist AccessTimeTracking. Dieses Feld ist zurzeit schreibgeschützt. |
|
| trackingGranularityInDays |
integer (int32) |
Das Feld gibt die Granularität der Blob-Objektverfolgung in Tagen an, in der Regel, wie oft das Blob-Objekt nachverfolgt werden soll. Dieses Feld ist zurzeit schreibgeschützt mit dem Wert 1 |
Name
Name der Richtlinie. Der gültige Wert ist AccessTimeTracking. Dieses Feld ist zurzeit schreibgeschützt.
| Wert | Beschreibung |
|---|---|
| AccessTimeTracking |
RestorePolicyProperties
Die Blobdiensteigenschaften für blob-Wiederherstellungsrichtlinie
| Name | Typ | Beschreibung |
|---|---|---|
| days |
integer (int32) minimum: 1maximum: 365 |
Wie lange dieses Blob wiederhergestellt werden kann. Es sollte groß sein als Null und kleiner als DeleteRetentionPolicy.days. |
| enabled |
boolean |
Blob-Wiederherstellung ist aktiviert, wenn sie auf "true" festgelegt ist. |
| lastEnabledTime |
string (date-time) |
Veraltet zugunsten der minRestoreTime-Eigenschaft. |
| minRestoreTime |
string (date-time) |
Gibt das Mindestdatum und die Mindestuhrzeit zurück, zu der die Wiederherstellung gestartet werden kann. |
Sku
Die SKU des Speicherkontos.
| Name | Typ | Beschreibung |
|---|---|---|
| name |
Der SKU-Name. Erforderlich für die Kontoerstellung; optional für Update. Beachten Sie, dass in älteren Versionen der SKU-Name "accountType" genannt wurde. |
|
| tier |
Die SKU-Ebene. Dies basiert auf dem SKU-Namen. |
SkuName
Der SKU-Name. Erforderlich für die Kontoerstellung; optional für Update. Beachten Sie, dass in älteren Versionen der SKU-Name "accountType" genannt wurde.
| Wert | Beschreibung |
|---|---|
| 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
Die SKU-Ebene. Dies basiert auf dem SKU-Namen.
| Wert | Beschreibung |
|---|---|
| Standard | |
| Premium |