Blob Services - Set Service Properties

  • Referentie
Service:
Storage Resource Provider
API Version:
2023-01-01

Hiermee stelt u de eigenschappen van de Blob-service van een opslagaccount in, inclusief eigenschappen voor Opslaganalyse- 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=2023-01-01

URI-parameters

Name In Vereist Type Description
accountName
 path True

string

De naam van het opslagaccount binnen de opgegeven resourcegroep. Opslagaccountnamen moeten tussen 3 en 24 tekens lang zijn en mogen alleen getallen en kleine letters bevatten.

Regex pattern: ^[a-z0-9]+$
BlobServicesName
 path True

BlobServicesName

De naam van de blobservice in het opgegeven opslagaccount. Blob-servicenaam moet 'standaard' zijn
resourceGroupName
 path True

string

De naam van de resourcegroep in het abonnement van de gebruiker. De naam is niet hoofdlettergevoelig.

Regex pattern: ^[-\w\._\(\)]+$
subscriptionId
 path True

string

De id van het doelabonnement.
api-version
 query True

string

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 blobservice voor voorlopig verwijderen van containers.
properties.cors

CorsRules

Hiermee geeft u CORS-regels voor de Blob-service op. U kunt maximaal vijf CorsRule-elementen in de aanvraag opnemen. 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 naar 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 blobservice voor voorlopig verwijderen van de blob.
properties.isVersioningEnabled

boolean

Versiebeheer is ingeschakeld als deze is ingesteld op true.
properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

De blobserviceeigenschap voor het configureren van het traceringsbeleid op basis van de laatste toegangstijd.
properties.restorePolicy

RestorePolicyProperties

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

Antwoorden

Name Type Description
200 OK

BlobServiceProperties

OK: hiermee stelt u de eigenschappen van de Blob-service van een opslagaccount in.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation uw gebruikersaccount imiteren

Voorbeelden

BlobServicesPutAllowPermanentDelete
BlobServicesPutLastAccessTimeBasedTracking
PutBlobServices

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

Status code:
200 
{
  "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

Status code:
200 
{
  "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

Status code:
200 
{
  "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"
  }
}

Definities

Name Description
AllowedMethods

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

De eigenschappen van de Blob-service van een opslagaccount.
BlobServicesName

De naam van de blobservice binnen het opgegeven opslagaccount. Blob-servicenaam moet 'standaard' zijn
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 in de aanvraag opnemen.
DeleteRetentionPolicy

De service-eigenschappen voor voorlopig verwijderen.
LastAccessTimeTrackingPolicy

De eigenschappen van de blobservice 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 blobherstelbeleid
Sku

De SKU van het opslagaccount.
SkuName

De SKU-naam. Vereist voor het maken van een account; optioneel voor bijwerken. Houd er rekening mee dat in oudere versies de naam van de SKU accountType werd genoemd.
SkuTier

De SKU-laag. Dit is gebaseerd op de naam van de SKU.

AllowedMethods

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

Name Type Description
CONNECT

string

DELETE

string

GET

string

HEAD

string

MERGE

string

OPTIONS

string

PATCH

string

POST

string

PUT

string

TRACE

string

BlobServiceProperties

De eigenschappen van de Blob-service van een opslagaccount.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Ex - /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 blobservice voor voorlopig verwijderen van containers.
properties.cors

CorsRules

Hiermee geeft u CORS-regels voor de Blob-service op. U kunt maximaal vijf CorsRule-elementen in de aanvraag opnemen. 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 naar 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 blobservice voor voorlopig verwijderen van de blob.
properties.isVersioningEnabled

boolean

Versiebeheer is ingeschakeld als deze is ingesteld op true.
properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

De blobserviceeigenschap voor het configureren van het traceringsbeleid op basis van de laatste toegangstijd.
properties.restorePolicy

RestorePolicyProperties

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

Sku

SKU-naam en -laag.
type

string

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

BlobServicesName

De naam van de blobservice binnen het opgegeven opslagaccount. Blob-servicenaam moet 'standaard' zijn

Name Type Description
default

string

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

Geeft de duur van changeFeed-retentie 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 element CorsRule aanwezig is. Een lijst met headers die deel mogen uitmaken van de aanvraag voor meerdere oorsprongen.
allowedMethods

AllowedMethods[]

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

string[]

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

string[]

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

integer

Vereist als het element CorsRule 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 in de aanvraag opnemen.

Name Type Description
corsRules

CorsRule[]

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

DeleteRetentionPolicy

De service-eigenschappen voor voorlopig verwijderen.

Name Type Description
allowPermanentDelete

boolean

Wanneer deze eigenschap is ingesteld op true, kunnen de voorlopig verwijderde blobversies en momentopnamen worden verwijderd. Deze eigenschap kan niet worden gebruikt blobherstelbeleid. Deze eigenschap is alleen van toepassing op de blobservice en niet op containers of bestandsshares.
days

integer

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

boolean

Geeft aan of DeleteRetentionPolicy is ingeschakeld.

LastAccessTimeTrackingPolicy

De eigenschappen van de blobservice 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

Wanneer deze optie is ingesteld op Waar, is tijdgebaseerde tracering op basis van tijd ingeschakeld.
name

name

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

integer

In het veld wordt de granulariteit van 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

Name Type Description
AccessTimeTracking

string

RestorePolicyProperties

De eigenschappen van de blob-service voor blobherstelbeleid

Name Type Description
days

integer

hoe lang deze blob kan worden hersteld. Het moet groter zijn dan nul en kleiner dan DeleteRetentionPolicy.days.
enabled

boolean

Blobherstel is ingeschakeld als deze is ingesteld op waar.
lastEnabledTime

string

Afgeschaft ten gunste van de eigenschap minRestoreTime.
minRestoreTime

string

Retourneert de minimale datum en tijd 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 een account; optioneel voor bijwerken. Houd er rekening mee dat in oudere versies de naam van de SKU accountType werd genoemd.
tier

SkuTier

De SKU-laag. Dit is gebaseerd op de naam van de SKU.

SkuName

De SKU-naam. Vereist voor het maken van een account; optioneel voor bijwerken. Houd er rekening mee dat in oudere versies de naam van de SKU accountType werd genoemd.

Name Type 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

De SKU-laag. Dit is gebaseerd op de naam van de SKU.

Name Type Description
Premium

string

Standard

string