Blob Services - Set Service Properties

Dienst:: Storage Resource Provider

API-Version:: 2025-08-01

Legt die Eigenschaften des Blob-Dienstes 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-08-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Der Name des Speicherkontos innerhalb der angegebenen Ressourcengruppe. Die Namen von Speicherkonten müssen zwischen 3 und 24 Zeichen lang sein und nur Zahlen und Kleinbuchstaben verwenden.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
properties.automaticSnapshotPolicyEnabled	boolean	Veraltet für isVersioningEnabled-Eigenschaft.
properties.changeFeed	ChangeFeed	Die Blobdiensteigenschaften für Änderungsfeedereignisse.
properties.containerDeleteRetentionPolicy	DeleteRetentionPolicy	Die Blob-Diensteigenschaften für das vorläufige Löschen von Containern.
properties.cors	CorsRules	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	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	LastAccessTimeTrackingPolicy	Die BLOB-Diensteigenschaft zum Konfigurieren der Richtlinie für die nach der letzten Zugriffszeit basierende Nachverfolgung.
properties.restorePolicy	RestorePolicyProperties	Die Blobdiensteigenschaften für die Blobwiederherstellungsrichtlinie.
properties.staticWebsite	StaticWebsite	Die statischen Website-Eigenschaften für Blob-Speicher.

Antworten

Name	Typ	Beschreibung
200 OK	BlobServiceProperties	Die Aktualisierungsoperation der Ressource 'BlobServiceProperties' war erfolgreich
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

BlobServicesPutAllowPermanentDelete

BlobServicesPutLastAccessTimeBasedTracking

PutBlobServices

BlobServicesPutAllowPermanentDelete

Beispielanforderung

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2025-08-01

{
  "properties": {
    "deleteRetentionPolicy": {
      "allowPermanentDelete": true,
      "days": 300,
      "enabled": true
    },
    "isVersioningEnabled": true
  }
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "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

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2025-08-01

{
  "properties": {
    "lastAccessTimeTrackingPolicy": {
      "name": "AccessTimeTracking",
      "blobType": [
        "blockBlob"
      ],
      "enable": true,
      "trackingGranularityInDays": 1
    }
  }
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "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

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2025-08-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,
    "staticWebsite": {
      "enabled": true,
      "indexDocument": "home.html",
      "errorDocument404Path": "site/errors/not-found.html"
    }
  }
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "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,
    "staticWebsite": {
      "enabled": true,
      "indexDocument": "home.html",
      "errorDocument404Path": "site/errors/not-found.html"
    }
  },
  "sku": {
    "name": "Standard_GRS",
    "tier": "Standard"
  }
}

Definitionen

Name	Beschreibung
AllowedMethods
BlobServiceProperties	Die Eigenschaften des BLOB-Diensts eines Speicherkontos.
ChangeFeed	Die Blobdiensteigenschaften für Änderungsfeedereignisse.
CorsRule	Gibt eine CORS-Regel für den Blob-Dienst an.
CorsRules	Legt die CORS-Regeln fest. Sie können bis zu fünf CorsRule-Elemente in die Anforderung aufnehmen.
DeleteRetentionPolicy	Die Diensteigenschaften für das vorläufige Löschen.
ErrorResponse	Eine Fehlerantwort des Speicherressourcenanbieters.
ErrorResponseBody	Fehlerantworttext-Vertrag.
LastAccessTimeTrackingPolicy	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.
RestorePolicyProperties	Die Blobdiensteigenschaften für blob-Wiederherstellungsrichtlinie
Sku	Die SKU des Speicherkontos.
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.
SkuTier	Die SKU-Ebene. Dies basiert auf dem SKU-Namen.
StaticWebsite	Die statischen Website-Eigenschaften für Blob-Speicher.

AllowedMethods

Enumeration

Wert	Beschreibung
DELETE
GET
HEAD
MERGE
POST
OPTIONS
PUT
PATCH
CONNECT
TRACE

BlobServiceProperties

Objekt

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	ChangeFeed	Die Blobdiensteigenschaften für Änderungsfeedereignisse.
properties.containerDeleteRetentionPolicy	DeleteRetentionPolicy	Die Blob-Diensteigenschaften für das vorläufige Löschen von Containern.
properties.cors	CorsRules	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	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	LastAccessTimeTrackingPolicy	Die BLOB-Diensteigenschaft zum Konfigurieren der Richtlinie für die nach der letzten Zugriffszeit basierende Nachverfolgung.
properties.restorePolicy	RestorePolicyProperties	Die Blobdiensteigenschaften für die Blobwiederherstellungsrichtlinie.
properties.staticWebsite	StaticWebsite	Die statischen Website-Eigenschaften für Blob-Speicher.
sku	Sku	SKU-Name und -Stufe.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ChangeFeed

Objekt

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: 1 maximum: 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

Objekt

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

Objekt

Legt die CORS-Regeln fest. Sie können bis zu fünf CorsRule-Elemente in die Anforderung aufnehmen.

Name	Typ	Beschreibung
corsRules	CorsRule[]	Die Liste der CORS-Regeln. Sie können bis zu fünf CorsRule-Elemente in die Anforderung aufnehmen.

DeleteRetentionPolicy

Objekt

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: 1 maximum: 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

Objekt

Eine Fehlerantwort des Speicherressourcenanbieters.

Name	Typ	Beschreibung
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Objekt

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

Objekt

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

Enumeration

Name der Richtlinie. Der gültige Wert ist AccessTimeTracking. Dieses Feld ist zurzeit schreibgeschützt.

Wert	Beschreibung
AccessTimeTracking

RestorePolicyProperties

Objekt

Die Blobdiensteigenschaften für blob-Wiederherstellungsrichtlinie

Name	Typ	Beschreibung
days	integer (int32) minimum: 1 maximum: 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

Objekt

Die SKU des Speicherkontos.

Name	Typ	Beschreibung
name	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.
tier	SkuTier	Die SKU-Ebene. Dies basiert auf dem SKU-Namen.

SkuName

Enumeration

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

Enumeration

Die SKU-Ebene. Dies basiert auf dem SKU-Namen.

Wert	Beschreibung
Standard
Premium

StaticWebsite

Objekt

Die statischen Website-Eigenschaften für Blob-Speicher.

Name	Typ	Beschreibung
defaultIndexDocumentPath	string	Der absolute Pfad, auf dem die Standard-Indexdatei vorhanden ist. Dieser absolute Pfad schließt sich gegenseitig von "indexDocument" aus und ist groß- und kleinschreibungssensitiv.
enabled	boolean	Gibt an, ob statische Website-Unterstützung für das angegebene Konto aktiviert ist.
errorDocument404Path	string	Der absolute Pfad zu einer Webseite, den Azure Storage für Anfragen bereitstellt, die nicht einer bestehenden Datei entsprechen. Der Inhalt der Seite wird mit HTTP 404 Nicht gefunden zurückgegeben. Auf jeder statischen Website wird nur eine einzelne benutzerdefinierte 404-Seite unterstützt.
indexDocument	string	Die Webseite, die für Anfragen an die Wurzel einer Website oder eines beliebigen Unterordners (zum Beispiel index.htmlbereitgestellt Azure Storage). Bei dem Wert wird die Groß-/Kleinschreibung beachtet.

Freigeben über

Blob Services - Set Service Properties

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

BlobServicesPutAllowPermanentDelete

Beispielanforderung

Beispiel für eine Antwort

BlobServicesPutLastAccessTimeBasedTracking

Beispielanforderung

Beispiel für eine Antwort

PutBlobServices

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AllowedMethods

BlobServiceProperties

ChangeFeed

CorsRule

CorsRules

DeleteRetentionPolicy

ErrorResponse

ErrorResponseBody

LastAccessTimeTrackingPolicy

Name

RestorePolicyProperties

Sku

SkuName

SkuTier

StaticWebsite