Blob Services - Set Service Properties
Establece las propiedades de blob service de una cuenta de almacenamiento, incluidas las propiedades de las reglas de Storage Analytics y CORS (uso compartido de recursos entre orígenes).
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2023-01-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nombre de la cuenta de almacenamiento dentro del grupo de recursos especificado. Los nombres de cuentas de almacenamiento deben tener entre 3 y 24 caracteres, y usar solo números y letras minúsculas. Regex pattern: |
Blob
|
path | True |
Nombre del servicio de blobs dentro de la cuenta de almacenamiento especificada. El nombre de Blob Service debe ser "predeterminado". |
|
resource
|
path | True |
string |
Nombre del grupo de recursos dentro de la suscripción del usuario. El nombre distingue mayúsculas de minúsculas. Regex pattern: |
subscription
|
path | True |
string |
Identificador de la suscripción de destino. |
api-version
|
query | True |
string |
Versión de API que se usará para la operación. |
Cuerpo de la solicitud
Nombre | Tipo | Description |
---|---|---|
properties.automaticSnapshotPolicyEnabled |
boolean |
En desuso en favor de la propiedad isVersioningEnabled. |
properties.changeFeed |
Propiedades de Blob Service para eventos de fuente de cambios. |
|
properties.containerDeleteRetentionPolicy |
Las propiedades de Blob Service para la eliminación temporal del contenedor. |
|
properties.cors |
Especifica las reglas de CORS para Blob service. Puede incluir hasta cinco elementos CorsRule en la solicitud. Si no se incluyen elementos CorsRule en el cuerpo de la solicitud, se eliminarán todas las reglas de CORS y CORS se deshabilitará para Blob Service. |
|
properties.defaultServiceVersion |
string |
DefaultServiceVersion indica la versión predeterminada que se va a usar para las solicitudes al servicio Blob si no se especifica la versión de una solicitud entrante. Los valores posibles incluyen la versión 2008-10-27 y todas las versiones más recientes. |
properties.deleteRetentionPolicy |
Las propiedades de Blob Service para la eliminación temporal de blobs. |
|
properties.isVersioningEnabled |
boolean |
El control de versiones está habilitado si se establece en true. |
properties.lastAccessTimeTrackingPolicy |
La propiedad blob service para configurar la directiva de seguimiento basada en la hora de último acceso. |
|
properties.restorePolicy |
Las propiedades de Blob Service para la directiva de restauración de blobs. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar: establece las propiedades de Blob Service de una cuenta de almacenamiento correctamente. |
Seguridad
azure_auth
Flujo OAuth2 de Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nombre | Description |
---|---|
user_impersonation | suplantación de su cuenta de usuario |
Ejemplos
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"
}
}
Definiciones
Nombre | Description |
---|---|
Allowed |
Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen puede ejecutar. |
Blob |
Propiedades de Blob Service de una cuenta de almacenamiento. |
Blob |
Nombre del servicio de blobs dentro de la cuenta de almacenamiento especificada. El nombre de Blob Service debe ser "predeterminado". |
Change |
Propiedades de Blob Service para eventos de fuente de cambios. |
Cors |
Especifica una regla de CORS para Blob service. |
Cors |
Establece las reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud. |
Delete |
Las propiedades del servicio para la eliminación temporal. |
Last |
Las propiedades de Blob Service para la directiva de seguimiento basada en la hora de último acceso. |
name |
Nombre de la directiva. El valor válido es AccessTimeTracking. Este campo es actualmente de solo lectura |
Restore |
Las propiedades de Blob Service para la directiva de restauración de blobs |
Sku |
SKU de la cuenta de almacenamiento. |
Sku |
El nombre de la SKU. Necesario para la creación de cuentas; opcional para la actualización. Tenga en cuenta que en versiones anteriores, el nombre de la SKU se llamó accountType. |
Sku |
Nivel de SKU. Esto se basa en el nombre de la SKU. |
AllowedMethods
Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen puede ejecutar.
Nombre | Tipo | Description |
---|---|---|
CONNECT |
string |
|
DELETE |
string |
|
GET |
string |
|
HEAD |
string |
|
MERGE |
string |
|
OPTIONS |
string |
|
PATCH |
string |
|
POST |
string |
|
PUT |
string |
|
TRACE |
string |
BlobServiceProperties
Propiedades de Blob Service de una cuenta de almacenamiento.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Nombre del recurso. |
properties.automaticSnapshotPolicyEnabled |
boolean |
En desuso en favor de la propiedad isVersioningEnabled. |
properties.changeFeed |
Propiedades de Blob Service para eventos de fuente de cambios. |
|
properties.containerDeleteRetentionPolicy |
Las propiedades de Blob Service para la eliminación temporal del contenedor. |
|
properties.cors |
Especifica las reglas de CORS para Blob service. Puede incluir hasta cinco elementos CorsRule en la solicitud. Si no se incluyen elementos CorsRule en el cuerpo de la solicitud, se eliminarán todas las reglas de CORS y CORS se deshabilitará para Blob Service. |
|
properties.defaultServiceVersion |
string |
DefaultServiceVersion indica la versión predeterminada que se va a usar para las solicitudes al servicio Blob si no se especifica la versión de una solicitud entrante. Los valores posibles incluyen la versión 2008-10-27 y todas las versiones más recientes. |
properties.deleteRetentionPolicy |
Las propiedades de Blob Service para la eliminación temporal de blobs. |
|
properties.isVersioningEnabled |
boolean |
El control de versiones está habilitado si se establece en true. |
properties.lastAccessTimeTrackingPolicy |
La propiedad blob service para configurar la directiva de seguimiento basada en la hora de último acceso. |
|
properties.restorePolicy |
Las propiedades de Blob Service para la directiva de restauración de blobs. |
|
sku |
Nombre y nivel de SKU. |
|
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
BlobServicesName
Nombre del servicio de blobs dentro de la cuenta de almacenamiento especificada. El nombre de Blob Service debe ser "predeterminado".
Nombre | Tipo | Description |
---|---|---|
default |
string |
ChangeFeed
Propiedades de Blob Service para eventos de fuente de cambios.
Nombre | Tipo | Description |
---|---|---|
enabled |
boolean |
Indica si el registro de eventos de fuente de cambios está habilitado para Blob service. |
retentionInDays |
integer |
Indica la duración de la retención de changeFeed en días. El valor mínimo es de 1 día y el valor máximo es de 146000 días (400 años). Un valor NULL indica una retención infinita de la fuente de cambios. |
CorsRule
Especifica una regla de CORS para Blob service.
Nombre | Tipo | Description |
---|---|---|
allowedHeaders |
string[] |
Obligatorio si el elemento CorsRule está presente. Lista de encabezados que pueden formar parte de la solicitud entre orígenes. |
allowedMethods |
Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen puede ejecutar. |
|
allowedOrigins |
string[] |
Obligatorio si el elemento CorsRule está presente. Una lista de dominios de origen que se permitirán a través de CORS o "*" para permitir todos los dominios |
exposedHeaders |
string[] |
Obligatorio si el elemento CorsRule está presente. Lista de encabezados de respuesta que se van a exponer a los clientes CORS. |
maxAgeInSeconds |
integer |
Obligatorio si el elemento CorsRule está presente. Número de segundos durante los cuales el cliente/explorador debe almacenar en memoria caché una respuesta de comprobaciones preparatorias. |
CorsRules
Establece las reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud.
Nombre | Tipo | Description |
---|---|---|
corsRules |
Cors |
La lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud. |
DeleteRetentionPolicy
Las propiedades del servicio para la eliminación temporal.
Nombre | Tipo | Description |
---|---|---|
allowPermanentDelete |
boolean |
Esta propiedad cuando se establece en true permite eliminar las instantáneas y las versiones de blobs eliminadas temporalmente. Esta propiedad no se puede usar la directiva de restauración de blobs. Esta propiedad solo se aplica a Blob Service y no se aplica a contenedores o recursos compartidos de archivos. |
days |
integer |
Indica el número de días que se debe conservar el elemento eliminado. El valor mínimo especificado puede ser 1 y el valor máximo puede ser 365. |
enabled |
boolean |
Indica si DeleteRetentionPolicy está habilitado. |
LastAccessTimeTrackingPolicy
Las propiedades de Blob Service para la directiva de seguimiento basada en la hora de último acceso.
Nombre | Tipo | Description |
---|---|---|
blobType |
string[] |
Matriz de tipos de blobs admitidos predefinidos. Solo blockBlob es el valor admitido. Este campo es actualmente de solo lectura |
enable |
boolean |
Cuando se establece en true, se habilita el seguimiento basado en la hora de último acceso. |
name |
Nombre de la directiva. El valor válido es AccessTimeTracking. Este campo es actualmente de solo lectura |
|
trackingGranularityInDays |
integer |
El campo especifica la granularidad de seguimiento de objetos de blob en días, normalmente con qué frecuencia se debe realizar el seguimiento del objeto de blob. Este campo es actualmente de solo lectura con el valor 1 |
name
Nombre de la directiva. El valor válido es AccessTimeTracking. Este campo es actualmente de solo lectura
Nombre | Tipo | Description |
---|---|---|
AccessTimeTracking |
string |
RestorePolicyProperties
Las propiedades de Blob Service para la directiva de restauración de blobs
Nombre | Tipo | Description |
---|---|---|
days |
integer |
cuánto tiempo se puede restaurar este blob. Debe ser grande que cero y menor que DeleteRetentionPolicy.days. |
enabled |
boolean |
La restauración de blobs está habilitada si se establece en true. |
lastEnabledTime |
string |
En desuso en favor de la propiedad minRestoreTime. |
minRestoreTime |
string |
Devuelve la fecha y hora mínimas en que se puede iniciar la restauración. |
Sku
SKU de la cuenta de almacenamiento.
Nombre | Tipo | Description |
---|---|---|
name |
El nombre de la SKU. Necesario para la creación de cuentas; opcional para la actualización. Tenga en cuenta que en versiones anteriores, el nombre de la SKU se llamó accountType. |
|
tier |
Nivel de SKU. Esto se basa en el nombre de la SKU. |
SkuName
El nombre de la SKU. Necesario para la creación de cuentas; opcional para la actualización. Tenga en cuenta que en versiones anteriores, el nombre de la SKU se llamó accountType.
Nombre | Tipo | 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
Nivel de SKU. Esto se basa en el nombre de la SKU.
Nombre | Tipo | Description |
---|---|---|
Premium |
string |
|
Standard |
string |