Blob Services - Set Service Properties
Anger egenskaperna för ett lagringskontos blobtjänst, inklusive egenskaper för Lagringsanalys- och CORS-regler (resursdelning mellan ursprung).
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2023-01-01
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
account
|
path | True |
string |
Namnet på lagringskontot i den angivna resursgruppen. Lagringskontonamn måste vara mellan 3 och 24 tecken långa och endast använda siffror och gemener. Regex pattern: |
Blob
|
path | True |
Namnet på blobtjänsten i det angivna lagringskontot. Blob Service-namnet måste vara "standard" |
|
resource
|
path | True |
string |
Namnet på resursgruppen i användarens prenumeration. Namnet är skiftlägesokänsligt. Regex pattern: |
subscription
|
path | True |
string |
ID för målprenumerationen. |
api-version
|
query | True |
string |
Den API-version som ska användas för den här åtgärden. |
Begärandetext
Name | Typ | Description |
---|---|---|
properties.automaticSnapshotPolicyEnabled |
boolean |
Inaktuell till förmån för egenskapen isVersioningEnabled. |
properties.changeFeed |
Blob-tjänstens egenskaper för ändringsflödeshändelser. |
|
properties.containerDeleteRetentionPolicy |
Blobtjänstegenskaperna för mjuk borttagning av containrar. |
|
properties.cors |
Anger CORS-regler för blobtjänsten. Du kan inkludera upp till fem CorsRule-element i begäran. Om inga CorsRule-element ingår i begärandetexten tas alla CORS-regler bort och CORS inaktiveras för Blob-tjänsten. |
|
properties.defaultServiceVersion |
string |
DefaultServiceVersion anger standardversionen som ska användas för begäranden till Blob-tjänsten om en inkommande begärans version inte har angetts. Möjliga värden är version 2008-10-27 och alla nyare versioner. |
properties.deleteRetentionPolicy |
Blob service-egenskaperna för mjuk borttagning av blobar. |
|
properties.isVersioningEnabled |
boolean |
Versionshantering är aktiverat om det är inställt på sant. |
properties.lastAccessTimeTrackingPolicy |
Blob Service-egenskapen för att konfigurera den senaste åtkomsttidsbaserade spårningsprincipen. |
|
properties.restorePolicy |
Blob-tjänstens egenskaper för principen för blobåterställning. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK – Anger egenskaperna för ett lagringskontos Blob Service. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | personifiera ditt användarkonto |
Exempel
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"
}
}
Definitioner
Name | Description |
---|---|
Allowed |
Krävs om Elementet CorsRule finns. En lista över HTTP-metoder som kan köras av ursprunget. |
Blob |
Egenskaperna för ett lagringskontos blobtjänst. |
Blob |
Namnet på blobtjänsten i det angivna lagringskontot. Blob Service-namnet måste vara "standard" |
Change |
Blob-tjänstens egenskaper för ändringsflödeshändelser. |
Cors |
Anger en CORS-regel för blobtjänsten. |
Cors |
Anger CORS-reglerna. Du kan inkludera upp till fem CorsRule-element i begäran. |
Delete |
Tjänstegenskaperna för mjuk borttagning. |
Last |
Blob-tjänstens egenskaper för spårningsprincipen Senaste åtkomsttid. |
name |
Namnet på principen. Det giltiga värdet är AccessTimeTracking. Det här fältet är för närvarande skrivskyddat |
Restore |
Blob Service-egenskaperna för principen för blobåterställning |
Sku |
SKU:n för lagringskontot. |
Sku |
SKU-namnet. Krävs för att skapa konto; valfritt för uppdatering. Observera att I äldre versioner kallades SKU-namnet accountType. |
Sku |
SKU-nivån. Detta baseras på SKU-namnet. |
AllowedMethods
Krävs om Elementet CorsRule finns. En lista över HTTP-metoder som kan köras av ursprunget.
Name | Typ | Description |
---|---|---|
CONNECT |
string |
|
DELETE |
string |
|
GET |
string |
|
HEAD |
string |
|
MERGE |
string |
|
OPTIONS |
string |
|
PATCH |
string |
|
POST |
string |
|
PUT |
string |
|
TRACE |
string |
BlobServiceProperties
Egenskaperna för ett lagringskontos blobtjänst.
Name | Typ | Description |
---|---|---|
id |
string |
Fullständigt kvalificerat resurs-ID för resursen. Exempel – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Namnet på resursen |
properties.automaticSnapshotPolicyEnabled |
boolean |
Inaktuell till förmån för egenskapen isVersioningEnabled. |
properties.changeFeed |
Blob-tjänstens egenskaper för ändringsflödeshändelser. |
|
properties.containerDeleteRetentionPolicy |
Blobtjänstegenskaperna för mjuk borttagning av containrar. |
|
properties.cors |
Anger CORS-regler för blobtjänsten. Du kan inkludera upp till fem CorsRule-element i begäran. Om inga CorsRule-element ingår i begärandetexten tas alla CORS-regler bort och CORS inaktiveras för Blob-tjänsten. |
|
properties.defaultServiceVersion |
string |
DefaultServiceVersion anger standardversionen som ska användas för begäranden till Blob-tjänsten om en inkommande begärans version inte har angetts. Möjliga värden är version 2008-10-27 och alla nyare versioner. |
properties.deleteRetentionPolicy |
Blob service-egenskaperna för mjuk borttagning av blobar. |
|
properties.isVersioningEnabled |
boolean |
Versionshantering är aktiverat om det är inställt på sant. |
properties.lastAccessTimeTrackingPolicy |
Blob Service-egenskapen för att konfigurera den senaste åtkomsttidsbaserade spårningsprincipen. |
|
properties.restorePolicy |
Blob-tjänstens egenskaper för principen för blobåterställning. |
|
sku |
SKU-namn och -nivå. |
|
type |
string |
Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts" |
BlobServicesName
Namnet på blobtjänsten i det angivna lagringskontot. Blob Service-namnet måste vara "standard"
Name | Typ | Description |
---|---|---|
default |
string |
ChangeFeed
Blob-tjänstens egenskaper för ändringsflödeshändelser.
Name | Typ | Description |
---|---|---|
enabled |
boolean |
Anger om händelseloggning för ändringsflöde är aktiverat för Blob Service. |
retentionInDays |
integer |
Anger varaktigheten för ändringFeed-kvarhållning i dagar. Minimivärdet är 1 dag och det maximala värdet är 146 000 dagar (400 år). Ett null-värde anger en oändlig kvarhållning av ändringsflödet. |
CorsRule
Anger en CORS-regel för blobtjänsten.
Name | Typ | Description |
---|---|---|
allowedHeaders |
string[] |
Krävs om Elementet CorsRule finns. En lista över rubriker som tillåts vara en del av begäran om korsande ursprung. |
allowedMethods |
Krävs om Elementet CorsRule finns. En lista över HTTP-metoder som kan köras av ursprunget. |
|
allowedOrigins |
string[] |
Krävs om Elementet CorsRule finns. En lista över ursprungsdomäner som tillåts via CORS eller "*" för att tillåta alla domäner |
exposedHeaders |
string[] |
Krävs om Elementet CorsRule finns. En lista över svarshuvuden som ska exponeras för CORS-klienter. |
maxAgeInSeconds |
integer |
Krävs om Elementet CorsRule finns. Antalet sekunder som klienten/webbläsaren ska cachelagrat ett förinställt svar. |
CorsRules
Anger CORS-reglerna. Du kan inkludera upp till fem CorsRule-element i begäran.
Name | Typ | Description |
---|---|---|
corsRules |
Cors |
Listan över CORS-regler. Du kan inkludera upp till fem CorsRule-element i begäran. |
DeleteRetentionPolicy
Tjänstegenskaperna för mjuk borttagning.
Name | Typ | Description |
---|---|---|
allowPermanentDelete |
boolean |
Den här egenskapen när värdet är true tillåter borttagning av de mjukt borttagna blobversionerna och ögonblicksbilderna. Det går inte att använda blobåterställningsprincipen för den här egenskapen. Den här egenskapen gäller endast för Blob Service och gäller inte för containrar eller filresurser. |
days |
integer |
Anger hur många dagar det borttagna objektet ska behållas. Det minsta angivna värdet kan vara 1 och det maximala värdet kan vara 365. |
enabled |
boolean |
Anger om DeleteRetentionPolicy är aktiverat. |
LastAccessTimeTrackingPolicy
Blob-tjänstens egenskaper för spårningsprincipen Senaste åtkomsttid.
Name | Typ | Description |
---|---|---|
blobType |
string[] |
En matris med fördefinierade blobtyper som stöds. Endast blockBlob är det värde som stöds. Det här fältet är för närvarande skrivskyddat |
enable |
boolean |
När värdet är true är spårning baserad på senaste åtkomsttid aktiverad. |
name |
Namnet på principen. Det giltiga värdet är AccessTimeTracking. Det här fältet är för närvarande skrivskyddat |
|
trackingGranularityInDays |
integer |
Fältet anger blobobjektets spårningskornighet i dagar, vanligtvis hur ofta blobobjektet ska spåras. Det här fältet är för närvarande skrivskyddat med värdet 1 |
name
Namnet på principen. Det giltiga värdet är AccessTimeTracking. Det här fältet är för närvarande skrivskyddat
Name | Typ | Description |
---|---|---|
AccessTimeTracking |
string |
RestorePolicyProperties
Blob Service-egenskaperna för principen för blobåterställning
Name | Typ | Description |
---|---|---|
days |
integer |
hur länge den här bloben kan återställas. Det bör vara bra än noll och mindre än DeleteRetentionPolicy.days. |
enabled |
boolean |
Blobåterställning är aktiverat om det är inställt på sant. |
lastEnabledTime |
string |
Inaktuell till förmån för egenskapen minRestoreTime. |
minRestoreTime |
string |
Returnerar det minsta datum och den tid som återställningen kan startas. |
Sku
SKU:n för lagringskontot.
Name | Typ | Description |
---|---|---|
name |
SKU-namnet. Krävs för att skapa konto; valfritt för uppdatering. Observera att I äldre versioner kallades SKU-namnet accountType. |
|
tier |
SKU-nivån. Detta baseras på SKU-namnet. |
SkuName
SKU-namnet. Krävs för att skapa konto; valfritt för uppdatering. Observera att I äldre versioner kallades SKU-namnet accountType.
Name | Typ | Description |
---|---|---|
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
SKU-nivån. Detta baseras på SKU-namnet.
Name | Typ | Description |
---|---|---|
Premium |
string |
|
Standard |
string |