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-объектов должно быть "по умолчанию" |
|
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
Имя группы ресурсов в подписке пользователя. Имя не зависит от регистра. |
subscription
|
path | True |
string minLength: 1 |
Идентификатор целевой подписки. |
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для данной операции. |
Текст запроса
Имя | Тип | Описание |
---|---|---|
properties.automaticSnapshotPolicyEnabled |
boolean |
Не рекомендуется использовать свойство isVersioningEnabled. |
properties.changeFeed |
Свойства службы BLOB-объектов для событий канала изменений. |
|
properties.containerDeleteRetentionPolicy |
Свойства службы BLOB-объектов для обратимого удаления контейнера. |
|
properties.cors |
Задает правила CORS для службы BLOB-объектов. В запрос можно включить до пяти элементов CorsRule. Если элементы CorsRule не включены в текст запроса, все правила CORS будут удалены, и CORS будет отключен для службы BLOB-объектов. |
|
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
Поток OAuth2 Azure Active Directory
Тип:
oauth2
Flow:
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-объектов должно быть "по умолчанию" |
Change |
Свойства службы BLOB-объектов для событий канала изменений. |
Cors |
Задает правило CORS для службы BLOB-объектов. |
Cors |
Задает правила CORS. В запрос можно включить до пяти элементов CorsRule. |
Delete |
Свойства службы для обратимого удаления. |
Last |
Свойства службы BLOB-объектов для политики отслеживания на основе времени последнего доступа. |
name |
Имя политики. Допустимое значение — AccessTimeTracking. Это поле в настоящее время доступно только для чтения |
Restore |
Свойства службы BLOB-объектов для политики восстановления BLOB-объектов |
Sku |
Номер SKU учетной записи хранения. |
Sku |
Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType. |
Sku |
Уровень SKU. Это основано на имени SKU. |
AllowedMethods
Требуется, если элемент CorsRule присутствует. Список методов HTTP, которые могут выполняться источником.
Значение | Описание |
---|---|
DELETE | |
GET | |
HEAD | |
MERGE | |
POST | |
OPTIONS | |
PUT | |
PATCH | |
CONNECT | |
TRACE |
BlobServiceProperties
Свойства службы BLOB-объектов учетной записи хранения.
Имя | Тип | Описание |
---|---|---|
id |
string |
Полный идентификатор ресурса для ресурса. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Имя ресурса |
properties.automaticSnapshotPolicyEnabled |
boolean |
Не рекомендуется использовать свойство isVersioningEnabled. |
properties.changeFeed |
Свойства службы BLOB-объектов для событий канала изменений. |
|
properties.containerDeleteRetentionPolicy |
Свойства службы BLOB-объектов для обратимого удаления контейнера. |
|
properties.cors |
Задает правила CORS для службы BLOB-объектов. В запрос можно включить до пяти элементов CorsRule. Если элементы CorsRule не включены в текст запроса, все правила CORS будут удалены, и CORS будет отключен для службы BLOB-объектов. |
|
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 |
ChangeFeed
Свойства службы BLOB-объектов для событий канала изменений.
Имя | Тип | Описание |
---|---|---|
enabled |
boolean |
Указывает, включена ли ведение журнала событий канала изменений для службы BLOB-объектов. |
retentionInDays |
integer (int32) minimum: 1maximum: 146000 |
Указывает длительность хранения changeFeed в днях. Минимальное значение равно 1 день и максимальное значение — 146000 дней (400 лет). Значение NULL означает бесконечное хранение канала изменений. |
CorsRule
Задает правило CORS для службы BLOB-объектов.
Имя | Тип | Описание |
---|---|---|
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-объектов и не применяется к контейнерам или общей папке. |
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-объектов в днях, как правило, частоту отслеживания объекта БОЛЬШОго двоичного объекта. Это поле в настоящее время считывается только со значением 1 |
name
Имя политики. Допустимое значение — AccessTimeTracking. Это поле в настоящее время доступно только для чтения
Значение | Описание |
---|---|
AccessTimeTracking |
RestorePolicyProperties
Свойства службы BLOB-объектов для политики восстановления BLOB-объектов
Имя | Тип | Описание |
---|---|---|
days |
integer minimum: 1maximum: 365 |
как долго этот большой двоичный объект можно восстановить. Оно должно быть больше нуля и меньше, чем DeleteRetentionPolicy.days. |
enabled |
boolean |
Восстановление BLOB-объектов включено, если задано значение true. |
lastEnabledTime |
string (date-time) |
Не рекомендуется использовать свойство minRestoreTime. |
minRestoreTime |
string (date-time) |
Возвращает минимальную дату и время запуска восстановления. |
Sku
Номер SKU учетной записи хранения.
Имя | Тип | Описание |
---|---|---|
name |
Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType. |
|
tier |
Уровень SKU. Это основано на имени SKU. |
SkuName
Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType.
Значение | Описание |
---|---|
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
Уровень SKU. Это основано на имени SKU.
Значение | Описание |
---|---|
Standard | |
Premium |