Delen via


Blob Services - Set Service Properties

Hiermee stelt u de eigenschappen in van de Blob-service van een opslagaccount, inclusief eigenschappen voor Storage Analytics en CORS-regels (Cross-Origin Resource Sharing).

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2025-06-01

URI-parameters

Name In Vereist Type Description
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

De naam van het opslagaccount binnen de opgegeven resourcegroep. Namen van opslagaccounts mogen tussen de 3 en 24 tekens lang zijn en mogen alleen cijfers en kleine letters gebruiken.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.

subscriptionId
path True

string (uuid)

De id van het doelabonnement. De waarde moet een UUID zijn.

api-version
query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Type Description
properties.automaticSnapshotPolicyEnabled

boolean

Afgeschaft ten gunste van de eigenschap isVersioningEnabled.

properties.changeFeed

ChangeFeed

De eigenschappen van de blob-service voor wijzigingenfeed-gebeurtenissen.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

De eigenschappen van de Blob-service voor voorlopig verwijderen van containers.

properties.cors

CorsRules

Hiermee geeft u CORS-regels voor de Blob-service op. U kunt maximaal vijf CorsRule-elementen opnemen in de aanvraag. Als er geen CorsRule-elementen zijn opgenomen in de aanvraagbody, worden alle CORS-regels verwijderd en wordt CORS uitgeschakeld voor de Blob-service.

properties.defaultServiceVersion

string

DefaultServiceVersion geeft de standaardversie aan die moet worden gebruikt voor aanvragen voor de Blob-service als de versie van een binnenkomende aanvraag niet is opgegeven. Mogelijke waarden zijn versie 2008-10-27 en alle recentere versies.

properties.deleteRetentionPolicy

DeleteRetentionPolicy

De eigenschappen van de blob-service voor voorlopig verwijderen van blobs.

properties.isVersioningEnabled

boolean

Versiebeheer is ingeschakeld als deze is ingesteld op true.

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

De blob-service-eigenschap voor het configureren van het beleid voor het bijhouden van laatste toegangstijd.

properties.restorePolicy

RestorePolicyProperties

De eigenschappen van de blob-service voor het herstelbeleid voor blobs.

Antwoorden

Name Type Description
200 OK

BlobServiceProperties

De updateoperatie van de bron 'BlobServiceProperties' is geslaagd

Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

BlobServicesPutAllowPermanentDelete
BlobServicesPutLastAccessTimeBasedTracking
PutBlobServices

BlobServicesPutAllowPermanentDelete

Voorbeeldaanvraag

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
  }
}

Voorbeeldrespons

{
  "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

Voorbeeldaanvraag

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
    }
  }
}

Voorbeeldrespons

{
  "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

Voorbeeldaanvraag

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
  }
}

Voorbeeldrespons

{
  "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"
  }
}

Definities

Name Description
AllowedMethods
BlobServiceProperties

De eigenschappen van de Blob-service van een opslagaccount.

ChangeFeed

De eigenschappen van de blob-service voor wijzigingenfeed-gebeurtenissen.

CorsRule

Hiermee geeft u een CORS-regel voor de Blob-service.

CorsRules

Hiermee stelt u de CORS-regels in. U kunt maximaal vijf CorsRule-elementen opnemen in de aanvraag.

DeleteRetentionPolicy

De service-eigenschappen voor voorlopig verwijderen.

ErrorResponse

Een foutreactie van de opslagresourceprovider.

ErrorResponseBody

Contract voor antwoordtekst van fout.

LastAccessTimeTrackingPolicy

De eigenschappen van de blob-service voor het traceringsbeleid op basis van de laatste toegangstijd.

Name

Naam van het beleid. De geldige waarde is AccessTimeTracking. Dit veld is momenteel alleen-lezen

RestorePolicyProperties

De eigenschappen van de blob-service voor het herstelbeleid voor blobs

Sku

De SKU van het opslagaccount.

SkuName

De SKU-naam. Vereist voor het maken van accounts; optioneel voor update. Houd er rekening mee dat in oudere versies de SKU-naam accountType is genoemd.

SkuTier

Het SKU-niveau. Dit is gebaseerd op de SKU-naam.

AllowedMethods

Waarde Description
DELETE
GET
HEAD
MERGE
POST
OPTIONS
PUT
PATCH
CONNECT
TRACE

BlobServiceProperties

De eigenschappen van de Blob-service van een opslagaccount.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

De naam van de resource

properties.automaticSnapshotPolicyEnabled

boolean

Afgeschaft ten gunste van de eigenschap isVersioningEnabled.

properties.changeFeed

ChangeFeed

De eigenschappen van de blob-service voor wijzigingenfeed-gebeurtenissen.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

De eigenschappen van de Blob-service voor voorlopig verwijderen van containers.

properties.cors

CorsRules

Hiermee geeft u CORS-regels voor de Blob-service op. U kunt maximaal vijf CorsRule-elementen opnemen in de aanvraag. Als er geen CorsRule-elementen zijn opgenomen in de aanvraagbody, worden alle CORS-regels verwijderd en wordt CORS uitgeschakeld voor de Blob-service.

properties.defaultServiceVersion

string

DefaultServiceVersion geeft de standaardversie aan die moet worden gebruikt voor aanvragen voor de Blob-service als de versie van een binnenkomende aanvraag niet is opgegeven. Mogelijke waarden zijn versie 2008-10-27 en alle recentere versies.

properties.deleteRetentionPolicy

DeleteRetentionPolicy

De eigenschappen van de blob-service voor voorlopig verwijderen van blobs.

properties.isVersioningEnabled

boolean

Versiebeheer is ingeschakeld als deze is ingesteld op true.

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

De blob-service-eigenschap voor het configureren van het beleid voor het bijhouden van laatste toegangstijd.

properties.restorePolicy

RestorePolicyProperties

De eigenschappen van de blob-service voor het herstelbeleid voor blobs.

sku

Sku

Sku naam en niveau.

type

string

Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ChangeFeed

De eigenschappen van de blob-service voor wijzigingenfeed-gebeurtenissen.

Name Type Description
enabled

boolean

Hiermee wordt aangegeven of logboekregistratie van wijzigingenfeeds is ingeschakeld voor de Blob-service.

retentionInDays

integer (int32)

minimum: 1
maximum: 146000

Geeft de duur van de retentie van changeFeed in dagen aan. De minimumwaarde is 1 dag en de maximumwaarde is 146000 dagen (400 jaar). Een null-waarde geeft een oneindige retentie van de wijzigingenfeed aan.

CorsRule

Hiermee geeft u een CORS-regel voor de Blob-service.

Name Type Description
allowedHeaders

string[]

Vereist als het CorsRule-element aanwezig is. Een lijst met headers die deel mogen uitmaken van de cross-origin-aanvraag.

allowedMethods

AllowedMethods[]

Vereist als het CorsRule-element aanwezig is. Een lijst met HTTP-methoden die door de oorsprong mogen worden uitgevoerd.

allowedOrigins

string[]

Vereist als het CorsRule-element aanwezig is. Een lijst met oorspronkelijke domeinen die worden toegestaan via CORS of *om alle domeinen toe te staan

exposedHeaders

string[]

Vereist als het CorsRule-element aanwezig is. Een lijst met antwoordheaders om beschikbaar te maken voor CORS-clients.

maxAgeInSeconds

integer (int32)

Vereist als het CorsRule-element aanwezig is. Het aantal seconden dat de client/browser een voorbereidend antwoord in de cache moet opslaan.

CorsRules

Hiermee stelt u de CORS-regels in. U kunt maximaal vijf CorsRule-elementen opnemen in de aanvraag.

Name Type Description
corsRules

CorsRule[]

De lijst met CORS-regels. U kunt maximaal vijf CorsRule-elementen opnemen in de aanvraag.

DeleteRetentionPolicy

De service-eigenschappen voor voorlopig verwijderen.

Name Type Description
allowPermanentDelete

boolean

Deze eigenschap wanneer deze is ingesteld op waar, staat het verwijderen van de voorlopig verwijderde blobversies en momentopnamen toe. Deze eigenschap kan geen blobherstelbeleid worden gebruikt. Deze eigenschap is alleen van toepassing op blobservice en is niet van toepassing op containers of bestandsshares.

days

integer (int32)

minimum: 1
maximum: 365

Geeft het aantal dagen aan dat het verwijderde item moet worden bewaard. De minimaal opgegeven waarde kan 1 zijn en de maximumwaarde kan 365 zijn.

enabled

boolean

Geeft aan of DeleteRetentionPolicy is ingeschakeld.

ErrorResponse

Een foutreactie van de opslagresourceprovider.

Name Type Description
error

ErrorResponseBody

Fouttekst van Azure Storage Resource Provider.

ErrorResponseBody

Contract voor antwoordtekst van fout.

Name Type Description
code

string

Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.

message

string

Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.

LastAccessTimeTrackingPolicy

De eigenschappen van de blob-service voor het traceringsbeleid op basis van de laatste toegangstijd.

Name Type Description
blobType

string[]

Een matrix met vooraf gedefinieerde ondersteunde blobtypen. Alleen blockBlob is de ondersteunde waarde. Dit veld is momenteel alleen-lezen

enable

boolean

Als deze optie is ingesteld op true last access time based tracking is enabled.

name

Name

Naam van het beleid. De geldige waarde is AccessTimeTracking. Dit veld is momenteel alleen-lezen

trackingGranularityInDays

integer (int32)

In het veld wordt de granulariteit voor het bijhouden van blobobjecten in dagen opgegeven, meestal hoe vaak het blobobject moet worden bijgehouden. Dit veld is momenteel alleen-lezen met de waarde 1

Name

Naam van het beleid. De geldige waarde is AccessTimeTracking. Dit veld is momenteel alleen-lezen

Waarde Description
AccessTimeTracking

RestorePolicyProperties

De eigenschappen van de blob-service voor het herstelbeleid voor blobs

Name Type Description
days

integer (int32)

minimum: 1
maximum: 365

hoe lang deze blob kan worden hersteld. Het moet geweldig zijn dan nul en minder dan DeleteRetentionPolicy.days.

enabled

boolean

Blob-herstel is ingeschakeld als deze is ingesteld op waar.

lastEnabledTime

string (date-time)

Afgeschaft ten gunste van de eigenschap minRestoreTime.

minRestoreTime

string (date-time)

Geeft de minimale datum en tijd terug waarop het herstel kan worden gestart.

Sku

De SKU van het opslagaccount.

Name Type Description
name

SkuName

De SKU-naam. Vereist voor het maken van accounts; optioneel voor update. Houd er rekening mee dat in oudere versies de SKU-naam accountType is genoemd.

tier

SkuTier

Het SKU-niveau. Dit is gebaseerd op de SKU-naam.

SkuName

De SKU-naam. Vereist voor het maken van accounts; optioneel voor update. Houd er rekening mee dat in oudere versies de SKU-naam accountType is genoemd.

Waarde Description
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

Het SKU-niveau. Dit is gebaseerd op de SKU-naam.

Waarde Description
Standard
Premium