Udostępnij przez


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

string

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

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

subscriptionId
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

ChangeFeed

Właściwości usługi blob dla zdarzeń zestawienia zmian.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

Właściwości usługi blob dla usuwania nietrwałego kontenera.

properties.cors

CorsRules

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

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

LastAccessTimeTrackingPolicy

Właściwość usługi blob, aby skonfigurować zasady śledzenia oparte na czasie ostatniego dostępu.

properties.restorePolicy

RestorePolicyProperties

Właściwości usługi blob dla zasad przywracania obiektów blob.

Odpowiedzi

Nazwa Typ Opis
200 OK

BlobServiceProperties

Operacja aktualizacji zasobu 'BlobServiceProperties' zakończyła się sukcesem

Other Status Codes

ErrorResponse

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

BlobServicesPutAllowPermanentDelete
BlobServicesPutLastAccessTimeBasedTracking
PutBlobServices

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
AllowedMethods
BlobServiceProperties

Właściwości usługi Blob konta magazynu.

ChangeFeed

Właściwości usługi blob dla zdarzeń zestawienia zmian.

CorsRule

Określa regułę CORS dla usługi Blob Service.

CorsRules

Ustawia reguły CORS. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule.

DeleteRetentionPolicy

Właściwości usługi do usuwania nietrwałego.

ErrorResponse

Odpowiedź dostawcy zasobów magazynu na błąd.

ErrorResponseBody

Kontrakt treści odpowiedzi na błąd.

LastAccessTimeTrackingPolicy

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

RestorePolicyProperties

Właściwości usługi blob dla zasad przywracania obiektów blob

Sku

Jednostka SKU konta magazynu.

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.

SkuTier

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

ChangeFeed

Właściwości usługi blob dla zdarzeń zestawienia zmian.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

Właściwości usługi blob dla usuwania nietrwałego kontenera.

properties.cors

CorsRules

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

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

LastAccessTimeTrackingPolicy

Właściwość usługi blob, aby skonfigurować zasady śledzenia oparte na czasie ostatniego dostępu.

properties.restorePolicy

RestorePolicyProperties

Właściwości usługi blob dla zasad przywracania obiektów blob.

sku

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

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

CorsRule[]

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

ErrorResponseBody

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

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

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.

tier

SkuTier

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