Freigeben über


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
accountName
path True

string

minLength: 3
maxLength: 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.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
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

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.

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

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

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

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

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.

sku

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

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

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

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

Eine Fehlerantwort des Speicherressourcenanbieters.

Name Typ Beschreibung
error

ErrorResponseBody

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

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

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

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