Blob Services - Set Service Properties
设置存储帐户的 Blob 服务的属性,包括存储分析和 CORS(跨域资源共享)规则的属性。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2024-01-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-z0-9]+$ |
指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。 |
Blob
|
path | True |
指定存储帐户中的 Blob 服务的名称。 Blob 服务名称必须为“default” |
|
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
用户订阅中的资源组的名称。 此名称不区分大小写。 |
subscription
|
path | True |
string minLength: 1 |
目标订阅的 ID。 |
api-version
|
query | True |
string minLength: 1 |
用于此操作的 API 版本。 |
请求正文
名称 | 类型 | 说明 |
---|---|---|
properties.automaticSnapshotPolicyEnabled |
boolean |
弃用支持 isVersioningEnabled 属性。 |
properties.changeFeed |
更改源事件的 Blob 服务属性。 |
|
properties.containerDeleteRetentionPolicy |
容器软删除的 Blob 服务属性。 |
|
properties.cors |
指定 Blob 服务的 CORS 规则。 请求中最多可以包含五个 CorsRule 元素。 如果请求正文中不包含 CorsRule 元素,将删除所有 CORS 规则,并且将禁用 Blob 服务的 CORS。 |
|
properties.defaultServiceVersion |
string |
如果未指定传入请求的版本,则 DefaultServiceVersion 指示用于对 Blob 服务的请求的默认版本。 可能的值包括版本 2008-10-27 和所有较新版本。 |
properties.deleteRetentionPolicy |
Blob 软删除的 Blob 服务属性。 |
|
properties.isVersioningEnabled |
boolean |
如果设置为 true,则启用版本控制。 |
properties.lastAccessTimeTrackingPolicy |
用于配置基于上次访问时间的跟踪策略的 Blob 服务属性。 |
|
properties.restorePolicy |
Blob 还原策略的 Blob 服务属性。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
确定 - 成功设置存储帐户的 Blob 服务的属性。 |
安全性
azure_auth
Azure Active Directory OAuth2 流
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
Blob |
Blob |
Put |
BlobServicesPutAllowPermanentDelete
示例请求
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2024-01-01
{
"properties": {
"deleteRetentionPolicy": {
"enabled": true,
"days": 300,
"allowPermanentDelete": true
},
"isVersioningEnabled": true
}
}
示例响应
{
"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
示例请求
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2024-01-01
{
"properties": {
"lastAccessTimeTrackingPolicy": {
"enable": true,
"name": "AccessTimeTracking",
"trackingGranularityInDays": 1,
"blobType": [
"blockBlob"
]
}
}
}
示例响应
{
"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
示例请求
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2024-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
}
}
}
示例响应
{
"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"
}
}
定义
名称 | 说明 |
---|---|
Allowed |
如果存在 CorsRule 元素,则为必需。 源允许执行的 HTTP 方法的列表。 |
Blob |
存储帐户的 Blob 服务的属性。 |
Blob |
指定存储帐户中的 Blob 服务的名称。 Blob 服务名称必须为“default” |
Change |
更改源事件的 Blob 服务属性。 |
Cors |
指定 Blob 服务的 CORS 规则。 |
Cors |
设置 CORS 规则。 请求中最多可以包含五个 CorsRule 元素。 |
Delete |
软删除的服务属性。 |
Last |
基于上次访问时间的跟踪策略的 Blob 服务属性。 |
name |
策略的名称。 有效值为 AccessTimeTracking。 此字段当前为只读 |
Restore |
Blob 还原策略的 Blob 服务属性 |
Sku |
存储帐户的 SKU。 |
Sku |
SKU 名称。 创建帐户时需要;可选,用于更新。 请注意,在旧版本中,SKU 名称称为 accountType。 |
Sku |
SKU 层。 这基于 SKU 名称。 |
AllowedMethods
如果存在 CorsRule 元素,则为必需。 源允许执行的 HTTP 方法的列表。
值 | 说明 |
---|---|
CONNECT | |
DELETE | |
GET | |
HEAD | |
MERGE | |
OPTIONS | |
PATCH | |
POST | |
PUT | |
TRACE |
BlobServiceProperties
存储帐户的 Blob 服务的属性。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源的完全限定资源 ID。 Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
资源的名称 |
properties.automaticSnapshotPolicyEnabled |
boolean |
弃用支持 isVersioningEnabled 属性。 |
properties.changeFeed |
更改源事件的 Blob 服务属性。 |
|
properties.containerDeleteRetentionPolicy |
容器软删除的 Blob 服务属性。 |
|
properties.cors |
指定 Blob 服务的 CORS 规则。 请求中最多可以包含五个 CorsRule 元素。 如果请求正文中不包含 CorsRule 元素,将删除所有 CORS 规则,并且将禁用 Blob 服务的 CORS。 |
|
properties.defaultServiceVersion |
string |
如果未指定传入请求的版本,则 DefaultServiceVersion 指示用于对 Blob 服务的请求的默认版本。 可能的值包括版本 2008-10-27 和所有较新版本。 |
properties.deleteRetentionPolicy |
Blob 软删除的 Blob 服务属性。 |
|
properties.isVersioningEnabled |
boolean |
如果设置为 true,则启用版本控制。 |
properties.lastAccessTimeTrackingPolicy |
用于配置基于上次访问时间的跟踪策略的 Blob 服务属性。 |
|
properties.restorePolicy |
Blob 还原策略的 Blob 服务属性。 |
|
sku |
Sku 名称和层。 |
|
type |
string |
资源的类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts” |
BlobServicesName
指定存储帐户中的 Blob 服务的名称。 Blob 服务名称必须为“default”
值 | 说明 |
---|---|
default |
ChangeFeed
更改源事件的 Blob 服务属性。
名称 | 类型 | 说明 |
---|---|---|
enabled |
boolean |
指示是否为 Blob 服务启用了更改源事件日志记录。 |
retentionInDays |
integer (int32) minimum: 1maximum: 146000 |
指示 changeFeed 保留期(以天为单位)。 最小值为 1 天,最大值为 146000 天(400 年)。 null 值表示更改源的无限保留期。 |
CorsRule
指定 Blob 服务的 CORS 规则。
名称 | 类型 | 说明 |
---|---|---|
allowedHeaders |
string[] |
如果存在 CorsRule 元素,则为必需。 允许作为跨域请求的一部分的标头列表。 |
allowedMethods |
如果存在 CorsRule 元素,则为必需。 源允许执行的 HTTP 方法的列表。 |
|
allowedOrigins |
string[] |
如果存在 CorsRule 元素,则为必需。 将允许通过 CORS 或“*”允许所有域的源域列表 |
exposedHeaders |
string[] |
如果存在 CorsRule 元素,则为必需。 要向 CORS 客户端公开的响应标头列表。 |
maxAgeInSeconds |
integer |
如果存在 CorsRule 元素,则为必需。 客户端/浏览器应缓存预检响应的秒数。 |
CorsRules
设置 CORS 规则。 请求中最多可以包含五个 CorsRule 元素。
名称 | 类型 | 说明 |
---|---|---|
corsRules |
Cors |
CORS 规则列表。 请求中最多可以包含五个 CorsRule 元素。 |
DeleteRetentionPolicy
软删除的服务属性。
名称 | 类型 | 说明 |
---|---|---|
allowPermanentDelete |
boolean |
如果设置为 true,则此属性允许删除软删除的 Blob 版本和快照。 此属性不能使用 Blob 还原策略。 此属性仅适用于 Blob 服务,不适用于容器或文件共享。 |
days |
integer minimum: 1maximum: 365 |
指示应保留已删除项的天数。 最小指定值可以是 1,最大值可以为 365。 |
enabled |
boolean |
指示是否启用 DeleteRetentionPolicy。 |
LastAccessTimeTrackingPolicy
基于上次访问时间的跟踪策略的 Blob 服务属性。
名称 | 类型 | 说明 |
---|---|---|
blobType |
string[] |
预定义支持的 Blob 类型的数组。 仅 blockBlob 是受支持的值。 此字段当前为只读 |
enable |
boolean |
如果设置为 true,则启用基于上次访问时间的跟踪。 |
name |
策略的名称。 有效值为 AccessTimeTracking。 此字段当前为只读 |
|
trackingGranularityInDays |
integer (int32) |
该字段指定 Blob 对象跟踪粒度(以天为单位),通常应跟踪 Blob 对象的频率。此字段当前为 1 的只读 |
name
策略的名称。 有效值为 AccessTimeTracking。 此字段当前为只读
值 | 说明 |
---|---|
AccessTimeTracking |
RestorePolicyProperties
Blob 还原策略的 Blob 服务属性
名称 | 类型 | 说明 |
---|---|---|
days |
integer minimum: 1maximum: 365 |
可以还原此 Blob 的时长。 它应大于零且小于 DeleteRetentionPolicy.days。 |
enabled |
boolean |
如果设置为 true,则启用 Blob 还原。 |
lastEnabledTime |
string (date-time) |
弃用了 minRestoreTime 属性。 |
minRestoreTime |
string (date-time) |
返回可以启动还原的最小日期和时间。 |
Sku
存储帐户的 SKU。
名称 | 类型 | 说明 |
---|---|---|
name |
SKU 名称。 创建帐户时需要;可选,用于更新。 请注意,在旧版本中,SKU 名称称为 accountType。 |
|
tier |
SKU 层。 这基于 SKU 名称。 |
SkuName
SKU 名称。 创建帐户时需要;可选,用于更新。 请注意,在旧版本中,SKU 名称称为 accountType。
值 | 说明 |
---|---|
PremiumV2_LRS | |
PremiumV2_ZRS | |
Premium_LRS | |
Premium_ZRS | |
StandardV2_GRS | |
StandardV2_GZRS | |
StandardV2_LRS | |
StandardV2_ZRS | |
Standard_GRS | |
Standard_GZRS | |
Standard_LRS | |
Standard_RAGRS | |
Standard_RAGZRS | |
Standard_ZRS |
SkuTier
SKU 层。 这基于 SKU 名称。
值 | 说明 |
---|---|
Premium | |
Standard |