Blob Services - Set Service Properties
Beállítja a tárfiók blobszolgáltatásának tulajdonságait, beleértve a Storage Analytics és a CORS (forrásközi erőforrás-megosztás) szabályainak tulajdonságait.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2023-01-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
account
|
path | True |
string |
A tárfiók neve a megadott erőforráscsoporton belül. A tárfiókneveknek 3 és 24 karakter közötti hosszúságúnak kell lenniük, és csak számokat és kisbetűket kell használniuk. Regex pattern: |
Blob
|
path | True |
A blobszolgáltatás neve a megadott tárfiókon belül. A blobszolgáltatás nevének alapértelmezettnek kell lennie |
|
resource
|
path | True |
string |
A felhasználó előfizetésében található erőforráscsoport neve. A név megkülönbözteti a kis- és nagybetűket. Regex pattern: |
subscription
|
path | True |
string |
A cél-előfizetés azonosítója. |
api-version
|
query | True |
string |
A művelethez használandó API-verzió. |
Kérelem törzse
Name | Típus | Description |
---|---|---|
properties.automaticSnapshotPolicyEnabled |
boolean |
Elavult az isVersioningEnabled tulajdonság javára. |
properties.changeFeed |
A blobszolgáltatás tulajdonságai a változáscsatorna-eseményekhez. |
|
properties.containerDeleteRetentionPolicy |
A tároló helyreállítható törlésének blobszolgáltatás-tulajdonságai. |
|
properties.cors |
A Blob szolgáltatás CORS-szabályait adja meg. Legfeljebb öt CorsRule-elemet vehet fel a kérelembe. Ha a kérelemtörzs nem tartalmaz CorsRule-elemeket, az összes CORS-szabály törlődik, és a CORS le lesz tiltva a Blob szolgáltatásban. |
|
properties.defaultServiceVersion |
string |
A DefaultServiceVersion azt az alapértelmezett verziót jelöli, amelyet a Blob-szolgáltatásnak küldött kérésekhez használni kell, ha a bejövő kérés verziója nincs megadva. A lehetséges értékek közé tartozik a 2008-10-27-es verzió és az összes újabb verzió. |
properties.deleteRetentionPolicy |
A blobszolgáltatás tulajdonságai a blob helyreállítható törléséhez. |
|
properties.isVersioningEnabled |
boolean |
A verziószámozás engedélyezve van, ha igaz értékre van állítva. |
properties.lastAccessTimeTrackingPolicy |
A blobszolgáltatás tulajdonsága a legutóbbi hozzáférési időalapú nyomkövetési szabályzat konfigurálásához. |
|
properties.restorePolicy |
A blob-visszaállítási szabályzat blobszolgáltatás-tulajdonságai. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK – A tárfiók blobszolgáltatásának tulajdonságainak beállítása sikeresen. |
Biztonság
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 | felhasználói fiók megszemélyesítése |
Példák
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"
}
}
Definíciók
Name | Description |
---|---|
Allowed |
Kötelező, ha CorsRule elem van jelen. A forrás által végrehajtható HTTP-metódusok listája. |
Blob |
A tárfiók Blob szolgáltatásának tulajdonságai. |
Blob |
A blobszolgáltatás neve a megadott tárfiókon belül. A blobszolgáltatás nevének alapértelmezettnek kell lennie |
Change |
A blobszolgáltatás tulajdonságai a változáscsatorna-eseményekhez. |
Cors |
A Blob szolgáltatás CORS-szabályát adja meg. |
Cors |
Beállítja a CORS-szabályokat. Legfeljebb öt CorsRule-elemet vehet fel a kérelembe. |
Delete |
A helyreállítható törlés szolgáltatástulajdonságai. |
Last |
A blobszolgáltatás tulajdonságai a Legutóbbi hozzáférés időpontja alapú nyomkövetési szabályzathoz. |
name |
A szabályzat neve. Az érvényes érték az AccessTimeTracking. Ez a mező jelenleg csak olvasható |
Restore |
A blob-visszaállítási szabályzat blobszolgáltatás-tulajdonságai |
Sku |
A tárfiók termékváltozata. |
Sku |
A termékváltozat neve. A fiók létrehozásához szükséges; nem kötelező a frissítéshez. Vegye figyelembe, hogy a régebbi verziókban a termékváltozat neve accountType volt. |
Sku |
A termékváltozat szintje. Ez a termékváltozat neve alapján történik. |
AllowedMethods
Kötelező, ha CorsRule elem van jelen. A forrás által végrehajtható HTTP-metódusok listája.
Name | Típus | Description |
---|---|---|
CONNECT |
string |
|
DELETE |
string |
|
GET |
string |
|
HEAD |
string |
|
MERGE |
string |
|
OPTIONS |
string |
|
PATCH |
string |
|
POST |
string |
|
PUT |
string |
|
TRACE |
string |
BlobServiceProperties
A tárfiók Blob szolgáltatásának tulajdonságai.
Name | Típus | Description |
---|---|---|
id |
string |
Az erőforrás teljes erőforrás-azonosítója. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Az erőforrás neve |
properties.automaticSnapshotPolicyEnabled |
boolean |
Elavult az isVersioningEnabled tulajdonság javára. |
properties.changeFeed |
A blobszolgáltatás tulajdonságai a változáscsatorna-eseményekhez. |
|
properties.containerDeleteRetentionPolicy |
A tároló helyreállítható törlésének blobszolgáltatás-tulajdonságai. |
|
properties.cors |
A Blob szolgáltatás CORS-szabályait adja meg. Legfeljebb öt CorsRule-elemet vehet fel a kérelembe. Ha a kérelemtörzs nem tartalmaz CorsRule-elemeket, az összes CORS-szabály törlődik, és a CORS le lesz tiltva a Blob szolgáltatásban. |
|
properties.defaultServiceVersion |
string |
A DefaultServiceVersion azt az alapértelmezett verziót jelöli, amelyet a Blob-szolgáltatásnak küldött kérésekhez használni kell, ha a bejövő kérés verziója nincs megadva. A lehetséges értékek közé tartozik a 2008-10-27-es verzió és az összes újabb verzió. |
properties.deleteRetentionPolicy |
A blobszolgáltatás tulajdonságai a blob helyreállítható törléséhez. |
|
properties.isVersioningEnabled |
boolean |
A verziószámozás engedélyezve van, ha igaz értékre van állítva. |
properties.lastAccessTimeTrackingPolicy |
A blobszolgáltatás tulajdonsága a legutóbbi hozzáférési időalapú nyomkövetési szabályzat konfigurálásához. |
|
properties.restorePolicy |
A blob-visszaállítási szabályzat blobszolgáltatás-tulajdonságai. |
|
sku |
Termékváltozat neve és szintje. |
|
type |
string |
Az erőforrás típusa. Például "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
BlobServicesName
A blobszolgáltatás neve a megadott tárfiókon belül. A blobszolgáltatás nevének alapértelmezettnek kell lennie
Name | Típus | Description |
---|---|---|
default |
string |
ChangeFeed
A blobszolgáltatás tulajdonságai a változáscsatorna-eseményekhez.
Name | Típus | Description |
---|---|---|
enabled |
boolean |
Azt jelzi, hogy engedélyezve van-e a változáscsatorna eseménynaplózása a Blob szolgáltatásban. |
retentionInDays |
integer |
A changeFeed adatmegőrzés időtartamát jelzi napokban. A minimális érték 1 nap, a maximális érték pedig 146000 nap (400 év). A null érték a változáscsatorna végtelen megőrzését jelzi. |
CorsRule
A Blob szolgáltatás CORS-szabályát adja meg.
Name | Típus | Description |
---|---|---|
allowedHeaders |
string[] |
Kötelező, ha CorsRule elem van jelen. Azoknak a fejléceknek a listája, amelyeket a forrásközi kérelem tartalmazhat. |
allowedMethods |
Kötelező, ha CorsRule elem van jelen. A forrás által végrehajtható HTTP-metódusok listája. |
|
allowedOrigins |
string[] |
Kötelező, ha CorsRule elem van jelen. Azon forrástartományok listája, amelyek a CORS-on keresztül lesznek engedélyezve, vagy "*" az összes tartomány engedélyezéséhez |
exposedHeaders |
string[] |
Kötelező, ha CorsRule elem van jelen. A CORS-ügyfelek számára közzéteendő válaszfejlécek listája. |
maxAgeInSeconds |
integer |
Kötelező, ha CorsRule elem van jelen. Azon másodpercek száma, amikor az ügyfélnek/böngészőnek gyorsítótáraznia kell az elővizsgálati választ. |
CorsRules
Beállítja a CORS-szabályokat. Legfeljebb öt CorsRule-elemet vehet fel a kérelembe.
Name | Típus | Description |
---|---|---|
corsRules |
Cors |
A CORS-szabályok listája. Legfeljebb öt CorsRule-elemet vehet fel a kérelembe. |
DeleteRetentionPolicy
A helyreállítható törlés szolgáltatástulajdonságai.
Name | Típus | Description |
---|---|---|
allowPermanentDelete |
boolean |
Ez a tulajdonság, ha igaz értékre van állítva, lehetővé teszi a helyreállíthatóan törölt blobverziók és pillanatképek törlését. Ez a tulajdonság nem használható blob-visszaállítási szabályzatra. Ez a tulajdonság csak a blobszolgáltatásra vonatkozik, és nem vonatkozik a tárolókra vagy fájlmegosztásokra. |
days |
integer |
Azt jelzi, hogy hány napig kell megőrizni a törölt elemet. A minimálisan megadott érték lehet 1, a maximális érték pedig 365. |
enabled |
boolean |
Azt jelzi, hogy a DeleteRetentionPolicy engedélyezve van-e. |
LastAccessTimeTrackingPolicy
A blobszolgáltatás tulajdonságai a Legutóbbi hozzáférés időpontja alapú nyomkövetési szabályzathoz.
Name | Típus | Description |
---|---|---|
blobType |
string[] |
Előre definiált támogatott blobtípusok tömbje. Csak a blockBlob a támogatott érték. Ez a mező jelenleg csak olvasható |
enable |
boolean |
Ha az utolsó hozzáférési idő valódi értékére van állítva, a rendszer engedélyezi a nyomkövetést. |
name |
A szabályzat neve. Az érvényes érték az AccessTimeTracking. Ez a mező jelenleg csak olvasható |
|
trackingGranularityInDays |
integer |
A mező napok alatt határozza meg a blobobjektumok nyomon követésének részletességét, általában azt, hogy milyen gyakran kell nyomon követni a blobobjektumot. Ez a mező jelenleg csak 1 értékkel olvasható |
name
A szabályzat neve. Az érvényes érték az AccessTimeTracking. Ez a mező jelenleg csak olvasható
Name | Típus | Description |
---|---|---|
AccessTimeTracking |
string |
RestorePolicyProperties
A blob-visszaállítási szabályzat blobszolgáltatás-tulajdonságai
Name | Típus | Description |
---|---|---|
days |
integer |
mennyi ideig állítható vissza ez a blob. A DeleteRetentionPolicy.days értéknél nagyobbnak kell lennie nullánál és kevesebbnek. |
enabled |
boolean |
A blobok visszaállítása engedélyezve van, ha igaz értékre van állítva. |
lastEnabledTime |
string |
A minRestoreTime tulajdonság javára elavult. |
minRestoreTime |
string |
A visszaállítás indításának minimális dátumát és időpontját adja vissza. |
Sku
A tárfiók termékváltozata.
Name | Típus | Description |
---|---|---|
name |
A termékváltozat neve. A fiók létrehozásához szükséges; nem kötelező a frissítéshez. Vegye figyelembe, hogy a régebbi verziókban a termékváltozat neve accountType volt. |
|
tier |
A termékváltozat szintje. Ez a termékváltozat neve alapján történik. |
SkuName
A termékváltozat neve. A fiók létrehozásához szükséges; nem kötelező a frissítéshez. Vegye figyelembe, hogy a régebbi verziókban a termékváltozat neve accountType volt.
Name | Típus | 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
A termékváltozat szintje. Ez a termékváltozat neve alapján történik.
Name | Típus | Description |
---|---|---|
Premium |
string |
|
Standard |
string |