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 |
---|---|---|---|---|
account
|
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: |
Blob
|
path | True |
Der Name des Blobdiensts innerhalb des angegebenen Speicherkontos. Der Name des Blobdiensts muss "Standard" sein. |
|
resource
|
path | True |
string |
Der Name der Ressourcengruppe im Abonnement des Benutzers. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. Regex pattern: |
subscription
|
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 |
Die Blobdiensteigenschaften für Änderungsfeedereignisse. |
|
properties.containerDeleteRetentionPolicy |
Die Blobdiensteigenschaften für das vorläufige Löschen von Containern. |
|
properties.cors |
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 |
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 Blobdiensteigenschaft zum Konfigurieren der richtlinie für die nach der Letzten Zugriffszeit basierte Nachverfolgung. |
|
properties.restorePolicy |
Die Blobdiensteigenschaften für die Blobwiederherstellungsrichtlinie. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
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
Blob |
Blob |
Put |
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 |
---|---|
Allowed |
Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen. |
Blob |
Die Eigenschaften des Blobdiensts eines Speicherkontos. |
Blob |
Der Name des Blobdiensts innerhalb des angegebenen Speicherkontos. Blobdienstname muss "Standard" sein. |
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 einschließen. |
Delete |
Die Diensteigenschaften für vorläufiges Löschen. |
Last |
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. |
Restore |
Die Blobdiensteigenschaften für die Blobwiederherstellungsrichtlinie |
Sku |
Die SKU des Speicherkontos. |
Sku |
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. |
Sku |
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 |
Die Blobdiensteigenschaften für Änderungsfeedereignisse. |
|
properties.containerDeleteRetentionPolicy |
Die Blobdiensteigenschaften für das vorläufige Löschen von Containern. |
|
properties.cors |
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 |
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 Blobdiensteigenschaft zum Konfigurieren der richtlinie für die nach der Letzten Zugriffszeit basierte Nachverfolgung. |
|
properties.restorePolicy |
Die Blobdiensteigenschaften für die Blobwiederherstellungsrichtlinie. |
|
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 |
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 |
Cors |
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 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 |
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 |
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 |