Blob Services - Set Service Properties
Ustawia właściwości usługi Blob Service konta magazynu, w tym właściwości reguł analizy magazynu i CORS (udostępnianie zasobów między źródłami).
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2025-06-01
Parametry URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-z0-9]+$ |
Nazwa konta magazynu w określonej grupie zasobów. Nazwy kont magazynu muszą mieć długość od 3 do 24 znaków i mogą zawierać wyłącznie cyfry oraz małe litery. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
subscription
|
path | True |
string (uuid) |
Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Wersja interfejsu API do użycia dla tej operacji. |
Ciało żądania
| Nazwa | Typ | Opis |
|---|---|---|
| properties.automaticSnapshotPolicyEnabled |
boolean |
Przestarzałe na rzecz właściwości isVersioningEnabled. |
| properties.changeFeed |
Właściwości usługi blob dla zdarzeń zestawienia zmian. |
|
| properties.containerDeleteRetentionPolicy |
Właściwości usługi blob dla usuwania nietrwałego kontenera. |
|
| properties.cors |
Określa reguły CORS dla usługi Blob Service. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule. Jeśli żadne elementy CorsRule nie zostaną uwzględnione w treści żądania, wszystkie reguły CORS zostaną usunięte, a mechanizm CORS zostanie wyłączony dla usługi Blob Service. |
|
| properties.defaultServiceVersion |
string |
DefaultServiceVersion wskazuje domyślną wersję, która ma być używana w przypadku żądań do usługi Blob Service, jeśli nie określono wersji żądania przychodzącego. Możliwe wartości obejmują wersję 2008-10-27 i wszystkie nowsze wersje. |
| properties.deleteRetentionPolicy |
Właściwości usługi blob dla usuwania nietrwałego obiektu blob. |
|
| properties.isVersioningEnabled |
boolean |
Przechowywanie wersji jest włączone, jeśli ustawiono wartość true. |
| properties.lastAccessTimeTrackingPolicy |
Właściwość usługi blob, aby skonfigurować zasady śledzenia oparte na czasie ostatniego dostępu. |
|
| properties.restorePolicy |
Właściwości usługi blob dla zasad przywracania obiektów blob. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
Operacja aktualizacji zasobu 'BlobServiceProperties' zakończyła się sukcesem |
|
| Other Status Codes |
Nieoczekiwana odpowiedź na błąd. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 w usłudze Azure Active Directory.
Typ:
oauth2
Flow:
implicit
URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresów
| Nazwa | Opis |
|---|---|
| user_impersonation | personifikacja konta użytkownika |
Przykłady
|
Blob |
|
Blob |
|
Put |
BlobServicesPutAllowPermanentDelete
Przykładowa prośba
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
}
}
Przykładowa odpowiedź
{
"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
Przykładowa prośba
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
}
}
}
Przykładowa odpowiedź
{
"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
Przykładowa prośba
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
}
}
Przykładowa odpowiedź
{
"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"
}
}
Definicje
| Nazwa | Opis |
|---|---|
|
Allowed |
|
|
Blob |
Właściwości usługi Blob konta magazynu. |
|
Change |
Właściwości usługi blob dla zdarzeń zestawienia zmian. |
|
Cors |
Określa regułę CORS dla usługi Blob Service. |
|
Cors |
Ustawia reguły CORS. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule. |
|
Delete |
Właściwości usługi do usuwania nietrwałego. |
|
Error |
Odpowiedź dostawcy zasobów magazynu na błąd. |
|
Error |
Kontrakt treści odpowiedzi na błąd. |
|
Last |
Właściwości usługi blob dla zasad śledzenia opartego na czasie ostatniego dostępu. |
| Name |
Nazwa zasad. Prawidłową wartością jest AccessTimeTracking. To pole jest obecnie tylko do odczytu |
|
Restore |
Właściwości usługi blob dla zasad przywracania obiektów blob |
| Sku |
Jednostka SKU konta magazynu. |
|
Sku |
Nazwa jednostki SKU. Wymagane do utworzenia konta; opcjonalnie do aktualizacji. Należy pamiętać, że w starszych wersjach nazwa jednostki SKU nosiła nazwę accountType. |
|
Sku |
Poziom SKU. Jest to oparte na nazwie jednostki SKU. |
AllowedMethods
| Wartość | Opis |
|---|---|
| DELETE | |
| GET | |
| HEAD | |
| MERGE | |
| POST | |
| OPTIONS | |
| PUT | |
| PATCH | |
| CONNECT | |
| TRACE |
BlobServiceProperties
Właściwości usługi Blob konta magazynu.
| Nazwa | Typ | Opis |
|---|---|---|
| id |
string |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Przykład - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| name |
string |
Nazwa zasobu |
| properties.automaticSnapshotPolicyEnabled |
boolean |
Przestarzałe na rzecz właściwości isVersioningEnabled. |
| properties.changeFeed |
Właściwości usługi blob dla zdarzeń zestawienia zmian. |
|
| properties.containerDeleteRetentionPolicy |
Właściwości usługi blob dla usuwania nietrwałego kontenera. |
|
| properties.cors |
Określa reguły CORS dla usługi Blob Service. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule. Jeśli żadne elementy CorsRule nie zostaną uwzględnione w treści żądania, wszystkie reguły CORS zostaną usunięte, a mechanizm CORS zostanie wyłączony dla usługi Blob Service. |
|
| properties.defaultServiceVersion |
string |
DefaultServiceVersion wskazuje domyślną wersję, która ma być używana w przypadku żądań do usługi Blob Service, jeśli nie określono wersji żądania przychodzącego. Możliwe wartości obejmują wersję 2008-10-27 i wszystkie nowsze wersje. |
| properties.deleteRetentionPolicy |
Właściwości usługi blob dla usuwania nietrwałego obiektu blob. |
|
| properties.isVersioningEnabled |
boolean |
Przechowywanie wersji jest włączone, jeśli ustawiono wartość true. |
| properties.lastAccessTimeTrackingPolicy |
Właściwość usługi blob, aby skonfigurować zasady śledzenia oparte na czasie ostatniego dostępu. |
|
| properties.restorePolicy |
Właściwości usługi blob dla zasad przywracania obiektów blob. |
|
| sku |
Nazwa jednostki SKU i warstwa. |
|
| type |
string |
Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts" |
ChangeFeed
Właściwości usługi blob dla zdarzeń zestawienia zmian.
| Nazwa | Typ | Opis |
|---|---|---|
| enabled |
boolean |
Wskazuje, czy rejestrowanie zdarzeń zestawienia zmian jest włączone dla usługi Blob Service. |
| retentionInDays |
integer (int32) minimum: 1maximum: 146000 |
Wskazuje czas przechowywania zmianyFeed w dniach. Wartość minimalna to 1 dzień, a wartość maksymalna to 146000 dni (400 lat). Wartość null wskazuje nieskończone przechowywanie zestawienia zmian. |
CorsRule
Określa regułę CORS dla usługi Blob Service.
| Nazwa | Typ | Opis |
|---|---|---|
| allowedHeaders |
string[] |
Wymagane, jeśli element CorsRule jest obecny. Lista nagłówków, które mogą być częścią żądania między źródłami. |
| allowedMethods |
Wymagane, jeśli element CorsRule jest obecny. Lista metod HTTP, które mogą być wykonywane przez źródło. |
|
| allowedOrigins |
string[] |
Wymagane, jeśli element CorsRule jest obecny. Lista domen pochodzenia, które będą dozwolone za pośrednictwem mechanizmu CORS lub "*", aby zezwolić na wszystkie domeny |
| exposedHeaders |
string[] |
Wymagane, jeśli element CorsRule jest obecny. Lista nagłówków odpowiedzi, które mają być widoczne dla klientów CORS. |
| maxAgeInSeconds |
integer (int32) |
Wymagane, jeśli element CorsRule jest obecny. Liczba sekund, przez które klient/przeglądarka powinna buforować odpowiedź wstępną. |
CorsRules
Ustawia reguły CORS. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule.
| Nazwa | Typ | Opis |
|---|---|---|
| corsRules |
Cors |
Lista reguł CORS. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule. |
DeleteRetentionPolicy
Właściwości usługi do usuwania nietrwałego.
| Nazwa | Typ | Opis |
|---|---|---|
| allowPermanentDelete |
boolean |
Ta właściwość po ustawieniu wartości true umożliwia usunięcie nietrwałych wersji obiektów blob i migawek. Tej właściwości nie można używać zasad przywracania obiektów blob. Ta właściwość dotyczy tylko usługi blob i nie ma zastosowania do kontenerów ani udziału plików. |
| days |
integer (int32) minimum: 1maximum: 365 |
Wskazuje liczbę dni przechowywania usuniętego elementu. Minimalna określona wartość może wynosić 1, a maksymalna wartość może wynosić 365. |
| enabled |
boolean |
Wskazuje, czy opcja DeleteRetentionPolicy jest włączona. |
ErrorResponse
Odpowiedź dostawcy zasobów magazynu na błąd.
| Nazwa | Typ | Opis |
|---|---|---|
| error |
Treść odpowiedzi na błąd dostawcy zasobów usługi Azure Storage. |
ErrorResponseBody
Kontrakt treści odpowiedzi na błąd.
| Nazwa | Typ | Opis |
|---|---|---|
| code |
string |
Identyfikator błędu. Kody są niezmienne i mają być używane programowo. |
| message |
string |
Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika. |
LastAccessTimeTrackingPolicy
Właściwości usługi blob dla zasad śledzenia opartego na czasie ostatniego dostępu.
| Nazwa | Typ | Opis |
|---|---|---|
| blobType |
string[] |
Tablica wstępnie zdefiniowanych obsługiwanych typów obiektów blob. Obsługiwana jest tylko wartość blockBlob. To pole jest obecnie tylko do odczytu |
| enable |
boolean |
Po ustawieniu wartości true śledzenie na podstawie czasu ostatniego dostępu jest włączone. |
| name |
Nazwa zasad. Prawidłową wartością jest AccessTimeTracking. To pole jest obecnie tylko do odczytu |
|
| trackingGranularityInDays |
integer (int32) |
Pole określa stopień szczegółowości śledzenia obiektów blob w dniach, zazwyczaj jak często należy śledzić obiekt blob. To pole jest obecnie tylko do odczytu z wartością 1 |
Name
Nazwa zasad. Prawidłową wartością jest AccessTimeTracking. To pole jest obecnie tylko do odczytu
| Wartość | Opis |
|---|---|
| AccessTimeTracking |
RestorePolicyProperties
Właściwości usługi blob dla zasad przywracania obiektów blob
| Nazwa | Typ | Opis |
|---|---|---|
| days |
integer (int32) minimum: 1maximum: 365 |
jak długo można przywrócić ten obiekt blob. Powinna być świetna niż zero i mniejsza niż DeleteRetentionPolicy.days. |
| enabled |
boolean |
Przywracanie obiektów blob jest włączone, jeśli ustawiono wartość true. |
| lastEnabledTime |
string (date-time) |
Przestarzałe na rzecz właściwości minRestoreTime. |
| minRestoreTime |
string (date-time) |
Zwraca minimalną datę i godzinę, o której można rozpocząć odtwarzanie. |
Sku
Jednostka SKU konta magazynu.
| Nazwa | Typ | Opis |
|---|---|---|
| name |
Nazwa jednostki SKU. Wymagane do utworzenia konta; opcjonalnie do aktualizacji. Należy pamiętać, że w starszych wersjach nazwa jednostki SKU nosiła nazwę accountType. |
|
| tier |
Poziom SKU. Jest to oparte na nazwie jednostki SKU. |
SkuName
Nazwa jednostki SKU. Wymagane do utworzenia konta; opcjonalnie do aktualizacji. Należy pamiętać, że w starszych wersjach nazwa jednostki SKU nosiła nazwę accountType.
| Wartość | Opis |
|---|---|
| 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
Poziom SKU. Jest to oparte na nazwie jednostki SKU.
| Wartość | Opis |
|---|---|
| Standard | |
| Premium |