Blob Services - Set Service Properties

Legt die Eigenschaften des Blobdiensts 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=2023-01-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
accountName
path True

string

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.

Regex pattern: ^[a-z0-9]+$

BlobServicesName
path True

BlobServicesName

Der Name des Blobdiensts innerhalb des angegebenen Speicherkontos. Der Name des Blobdiensts muss "Standard" sein.

resourceGroupName
path True

string

Der Name der Ressourcengruppe im Abonnement des Benutzers. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Hierbei handelt es sich um die ID des Zielabonnements.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Typ Beschreibung
properties.automaticSnapshotPolicyEnabled

boolean

Ist zugunsten der isVersioningEnabled-Eigenschaft veraltet.

properties.changeFeed

ChangeFeed

Die Blobdiensteigenschaften für Änderungsfeedereignisse.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

Die Blobdiensteigenschaften für das vorläufige Löschen von Containern.

properties.cors

CorsRules

Gibt CORS-Regeln für den Blobdienst an. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen. Wenn keine CorsRule-Elemente im Anforderungstext enthalten sind, werden alle CORS-Regeln gelöscht, und CORS wird für den Blobdienst deaktiviert.

properties.defaultServiceVersion

string

DefaultServiceVersion gibt die Standardversion an, die für Anforderungen an den Blobdienst verwendet werden soll, wenn die Version einer eingehenden Anforderung nicht angegeben ist. Mögliche Werte sind Version 2008-10-27 und alle höheren 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 Blobdiensteigenschaft zum Konfigurieren der richtlinie für die nach der Letzten Zugriffszeit basierte Nachverfolgung.

properties.restorePolicy

RestorePolicyProperties

Die Blobdiensteigenschaften für die Blobwiederherstellungsrichtlinie.

Antworten

Name Typ Beschreibung
200 OK

BlobServiceProperties

OK : Legt die Eigenschaften des Blobdiensts eines Speicherkontos erfolgreich fest.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

BlobServicesPutAllowPermanentDelete
BlobServicesPutLastAccessTimeBasedTracking
PutBlobServices

BlobServicesPutAllowPermanentDelete

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2023-01-01

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

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/blobServices",
  "properties": {
    "deleteRetentionPolicy": {
      "enabled": true,
      "days": 300,
      "allowPermanentDelete": true
    },
    "isVersioningEnabled": true
  }
}

BlobServicesPutLastAccessTimeBasedTracking

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2023-01-01

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

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/blobServices",
  "properties": {
    "lastAccessTimeTrackingPolicy": {
      "enable": true,
      "name": "AccessTimeTracking",
      "trackingGranularityInDays": 1,
      "blobType": [
        "blockBlob"
      ]
    }
  }
}

PutBlobServices

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2023-01-01

{
  "properties": {
    "cors": {
      "corsRules": [
        {
          "allowedOrigins": [
            "http://www.contoso.com",
            "http://www.fabrikam.com"
          ],
          "allowedMethods": [
            "GET",
            "HEAD",
            "POST",
            "OPTIONS",
            "MERGE",
            "PUT"
          ],
          "maxAgeInSeconds": 100,
          "exposedHeaders": [
            "x-ms-meta-*"
          ],
          "allowedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ]
        },
        {
          "allowedOrigins": [
            "*"
          ],
          "allowedMethods": [
            "GET"
          ],
          "maxAgeInSeconds": 2,
          "exposedHeaders": [
            "*"
          ],
          "allowedHeaders": [
            "*"
          ]
        },
        {
          "allowedOrigins": [
            "http://www.abc23.com",
            "https://www.fabrikam.com/*"
          ],
          "allowedMethods": [
            "GET",
            "PUT"
          ],
          "maxAgeInSeconds": 2000,
          "exposedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x -ms-meta-target*"
          ],
          "allowedHeaders": [
            "x-ms-meta-12345675754564*"
          ]
        }
      ]
    },
    "defaultServiceVersion": "2017-07-29",
    "deleteRetentionPolicy": {
      "enabled": true,
      "days": 300
    },
    "isVersioningEnabled": true,
    "changeFeed": {
      "enabled": true,
      "retentionInDays": 7
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/blobServices",
  "properties": {
    "cors": {
      "corsRules": [
        {
          "allowedOrigins": [
            "http://www.contoso.com",
            "http://www.fabrikam.com"
          ],
          "allowedMethods": [
            "GET",
            "HEAD",
            "POST",
            "OPTIONS",
            "MERGE",
            "PUT"
          ],
          "maxAgeInSeconds": 100,
          "exposedHeaders": [
            "x-ms-meta-*"
          ],
          "allowedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ]
        },
        {
          "allowedOrigins": [
            "*"
          ],
          "allowedMethods": [
            "GET"
          ],
          "maxAgeInSeconds": 2,
          "exposedHeaders": [
            "*"
          ],
          "allowedHeaders": [
            "*"
          ]
        },
        {
          "allowedOrigins": [
            "http://www.abc23.com",
            "https://www.fabrikam.com/*"
          ],
          "allowedMethods": [
            "GET",
            "PUT"
          ],
          "maxAgeInSeconds": 2000,
          "exposedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x -ms-meta-target*"
          ],
          "allowedHeaders": [
            "x-ms-meta-12345675754564*"
          ]
        }
      ]
    },
    "defaultServiceVersion": "2017-07-29",
    "deleteRetentionPolicy": {
      "enabled": true,
      "days": 300
    },
    "isVersioningEnabled": true,
    "changeFeed": {
      "enabled": true,
      "retentionInDays": 7
    }
  },
  "sku": {
    "name": "Standard_GRS",
    "tier": "Standard"
  }
}

Definitionen

Name Beschreibung
AllowedMethods

Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen.

BlobServiceProperties

Die Eigenschaften des Blobdiensts eines Speicherkontos.

BlobServicesName

Der Name des Blobdiensts innerhalb des angegebenen Speicherkontos. Blobdienstname muss "Standard" sein.

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 einschließen.

DeleteRetentionPolicy

Die Diensteigenschaften für vorläufiges Löschen.

LastAccessTimeTrackingPolicy

Die Blobdiensteigenschaften für die Richtlinie für die zeitbasierte Nachverfolgung des letzten Zugriffs.

name

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

RestorePolicyProperties

Die Blobdiensteigenschaften für die Blobwiederherstellungsrichtlinie

Sku

Die SKU des Speicherkontos.

SkuName

Der SKU-Name. Erforderlich für die Kontoerstellung; optional für das Update. Beachten Sie, dass in älteren Versionen der SKU-Name accountType genannt wurde.

SkuTier

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

AllowedMethods

Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen.

Name Typ Beschreibung
CONNECT

string

DELETE

string

GET

string

HEAD

string

MERGE

string

OPTIONS

string

PATCH

string

POST

string

PUT

string

TRACE

string

BlobServiceProperties

Die Eigenschaften des Blobdiensts eines Speicherkontos.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Der Name der Ressource

properties.automaticSnapshotPolicyEnabled

boolean

Ist zugunsten der isVersioningEnabled-Eigenschaft veraltet.

properties.changeFeed

ChangeFeed

Die Blobdiensteigenschaften für Änderungsfeedereignisse.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

Die Blobdiensteigenschaften für das vorläufige Löschen von Containern.

properties.cors

CorsRules

Gibt CORS-Regeln für den Blobdienst an. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen. Wenn keine CorsRule-Elemente im Anforderungstext enthalten sind, werden alle CORS-Regeln gelöscht, und CORS wird für den Blobdienst deaktiviert.

properties.defaultServiceVersion

string

DefaultServiceVersion gibt die Standardversion an, die für Anforderungen an den Blobdienst verwendet werden soll, wenn die Version einer eingehenden Anforderung nicht angegeben ist. Mögliche Werte sind Version 2008-10-27 und alle höheren 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 Blobdiensteigenschaft zum Konfigurieren der richtlinie für die nach der Letzten Zugriffszeit basierte Nachverfolgung.

properties.restorePolicy

RestorePolicyProperties

Die Blobdiensteigenschaften für die Blobwiederherstellungsrichtlinie.

sku

Sku

SKU-Name und -Ebene.

type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

BlobServicesName

Der Name des Blobdiensts innerhalb des angegebenen Speicherkontos. Blobdienstname muss "Standard" sein.

Name Typ Beschreibung
default

string

ChangeFeed

Die Blobdiensteigenschaften für Änderungsfeedereignisse.

Name Typ Beschreibung
enabled

boolean

Gibt an, ob die Änderungsfeedereignisprotokollierung für den Blobdienst aktiviert ist.

retentionInDays

integer

Gibt die Dauer der ChangeFeed-Aufbewahrung in Tagen an. Der Mindestwert ist 1 Tag und der Höchstwert 146.000 Tage (400 Jahre). Ein NULL-Wert gibt eine unendliche Beibehaltung des Änderungsfeeds an.

CorsRule

Gibt eine CORS-Regel für den Blob-Dienst an.

Name Typ Beschreibung
allowedHeaders

string[]

Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste von Headern, die Teil der ursprungsübergreifenden Anforderung sein dürfen.

allowedMethods

AllowedMethods[]

Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen.

allowedOrigins

string[]

Erforderlich, wenn das 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 das CorsRule-Element vorhanden ist. Eine Liste von Antwortheadern, die für CORS-Clients verfügbar gemacht werden sollen.

maxAgeInSeconds

integer

Erforderlich, wenn das CorsRule-Element vorhanden ist. Gibt an, wie viele Sekunden eine Preflight-Antwort vom Client/Browser zwischengespeichert werden soll.

CorsRules

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

Name Typ Beschreibung
corsRules

CorsRule[]

Die Liste der CORS-Regeln. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen.

DeleteRetentionPolicy

Die Diensteigenschaften für vorläufiges 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 Blobversionen und Momentaufnahmen. Diese Eigenschaft kann nicht für die Blobwiederherstellung verwendet werden. Diese Eigenschaft gilt nur für den Blobdienst und gilt nicht für Container oder Dateifreigaben.

days

integer

Gibt die Anzahl der Tage an, in denen das gelöschte Element beibehalten werden soll. Der angegebene Mindestwert kann 1 und der Maximalwert 365 sein.

enabled

boolean

Gibt an, ob DeleteRetentionPolicy aktiviert ist.

LastAccessTimeTrackingPolicy

Die Blobdiensteigenschaften für die Richtlinie für die zeitbasierte Nachverfolgung des letzten Zugriffs.

Name Typ Beschreibung
blobType

string[]

Ein Array von vordefinierten unterstützten Blobtypen. Nur blockBlob ist der unterstützte Wert. Dieses Feld ist derzeit schreibgeschützt.

enable

boolean

Wenn auf true festgelegt ist, ist die zeitbasierte Nachverfolgung des letzten Zugriffs aktiviert.

name

name

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

trackingGranularityInDays

integer

Das Feld gibt die Granularität von Blobobjekten in Tagen an, in der Regel, wie oft das Blobobjekt nachverfolgt werden soll. Dieses Feld ist derzeit schreibgeschützt und hat den Wert 1.

name

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

Name Typ Beschreibung
AccessTimeTracking

string

RestorePolicyProperties

Die Blobdiensteigenschaften für die Blobwiederherstellungsrichtlinie

Name Typ Beschreibung
days

integer

wie lange dieses Blob wiederhergestellt werden kann. Es sollte größer als 0 und kleiner als DeleteRetentionPolicy.days sein.

enabled

boolean

Die Blobwiederherstellung ist aktiviert, wenn auf true festgelegt ist.

lastEnabledTime

string

Ist zugunsten der minRestoreTime-Eigenschaft veraltet.

minRestoreTime

string

Gibt das Mindestdatum und die Mindestzeit 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 das 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 das Update. Beachten Sie, dass in älteren Versionen der SKU-Name accountType genannt wurde.

Name Typ Beschreibung
Premium_LRS

string

Premium_ZRS

string

Standard_GRS

string

Standard_GZRS

string

Standard_LRS

string

Standard_RAGRS

string

Standard_RAGZRS

string

Standard_ZRS

string

SkuTier

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

Name Typ Beschreibung
Premium

string

Standard

string