Compartir a través de


Microsoft.Storage StorageAccounts/blobServices 2023-05-01

Definición de recursos de Bicep

El tipo de recurso storageAccounts/blobServices se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Storage/storageAccounts/blobServices, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Storage/storageAccounts/blobServices@2023-05-01' = {
  name: 'default'
  parent: resourceSymbolicName
  properties: {
    automaticSnapshotPolicyEnabled: bool
    changeFeed: {
      enabled: bool
      retentionInDays: int
    }
    containerDeleteRetentionPolicy: {
      allowPermanentDelete: bool
      days: int
      enabled: bool
    }
    cors: {
      corsRules: [
        {
          allowedHeaders: [
            'string'
          ]
          allowedMethods: [
            'string'
          ]
          allowedOrigins: [
            'string'
          ]
          exposedHeaders: [
            'string'
          ]
          maxAgeInSeconds: int
        }
      ]
    }
    defaultServiceVersion: 'string'
    deleteRetentionPolicy: {
      allowPermanentDelete: bool
      days: int
      enabled: bool
    }
    isVersioningEnabled: bool
    lastAccessTimeTrackingPolicy: {
      blobType: [
        'string'
      ]
      enable: bool
      name: 'AccessTimeTracking'
      trackingGranularityInDays: int
    }
    restorePolicy: {
      days: int
      enabled: bool
    }
  }
}

Valores de propiedad

storageAccounts/blobServices

Nombre Descripción Valor
nombre El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en Bicep.
'default'
padre En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.
Nombre simbólico del recurso de tipo: storageAccounts
Propiedades Propiedades de Blob service de una cuenta de almacenamiento. BlobServicePropertiesProperties

BlobServicePropertiesPropertiesProperties

Nombre Descripción Valor
automaticSnapshotPolicyEnabled En desuso en favor de la propiedad isVersioningEnabled. Bool
changeFeed Propiedades de Blob service para eventos de fuente de cambios. ChangeFeed
containerDeleteRetentionPolicy Las propiedades de Blob Service para la eliminación temporal del contenedor. DeleteRetentionPolicy
cors Especifica 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. corsRules
defaultServiceVersion DefaultServiceVersion indica la versión predeterminada que se va a usar para las solicitudes a Blob service 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. cuerda
deleteRetentionPolicy Las propiedades de Blob Service para la eliminación temporal de blobs. DeleteRetentionPolicy
isVersioningEnabled El control de versiones está habilitado si se establece en true. Bool
lastAccessTimeTrackingPolicy La propiedad blob service para configurar la directiva de seguimiento basada en la hora de último acceso. LastAccessTimeTrackingPolicy
restorePolicy Las propiedades de Blob Service para la directiva de restauración de blobs. restorePolicyProperties

ChangeFeed

Nombre Descripción Valor
Habilitado Indica si el registro de eventos de fuente de cambios está habilitado para Blob service. Bool
retentionInDays Indica la duración de la retención changeFeed en días. El valor mínimo es 1 día y el valor máximo es 146000 días (400 años). Un valor NULL indica una retención infinita de la fuente de cambios. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 146000

DeleteRetentionPolicy

Nombre Descripción Valor
allowPermanentDelete Esta propiedad cuando se establece en true permite la eliminación de las versiones y instantáneas del blob eliminado 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. Bool
Días 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. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 365
Habilitado Indica si DeleteRetentionPolicy está habilitado. Bool

CorsRules

Nombre Descripción Valor
corsRules Lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud. corsRule[]

CorsRule

Nombre Descripción Valor
allowedHeaders Obligatorio si el elemento CorsRule está presente. Lista de encabezados que pueden formar parte de la solicitud entre orígenes. string[] (obligatorio)
allowedMethods Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen permite ejecutar. Matriz de cadenas que contiene cualquiera de:
'CONNECT'
'DELETE'
'GET'
'HEAD'
'MERGE'
'OPTIONS'
'PATCH'
'POST'
'PUT'
'TRACE' (obligatorio)
allowedOrigins 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 string[] (obligatorio)
exposedHeaders Obligatorio si el elemento CorsRule está presente. Lista de encabezados de respuesta que se van a exponer a los clientes CORS. string[] (obligatorio)
maxAgeInSeconds Obligatorio si el elemento CorsRule está presente. Número de segundos que el cliente o explorador debe almacenar en caché una respuesta preparatoria. int (obligatorio)

LastAccessTimeTrackingPolicy

Nombre Descripción Valor
blobType Matriz de tipos de blobs admitidos predefinidos. Solo blockBlob es el valor admitido. Este campo es actualmente de solo lectura string[]
habilitar Cuando se establece en true, se habilita el seguimiento basado en la hora del último acceso. bool (obligatorio)
nombre Nombre de la directiva. El valor válido es AccessTimeTracking. Este campo es actualmente de solo lectura "AccessTimeTracking"
trackingGranularityInDays El campo especifica la granularidad de seguimiento de objetos de blob en días, normalmente la frecuencia con la que se debe realizar el seguimiento del objeto de blob. Este campo es actualmente de solo lectura con el valor 1 Int

RestorePolicyProperties

Nombre Descripción Valor
Días cuánto tiempo se puede restaurar este blob. Debe ser grande que cero y menor que DeleteRetentionPolicy.days. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 365
Habilitado La restauración de blobs está habilitada si se establece en true. bool (obligatorio)

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Azure Cloud Shell: de almacenamiento de red virtual

Implementación en Azure
Esta plantilla implementa el almacenamiento de Azure Cloud Shell en una red virtual de Azure.
Crear una de factoría de datos V2

Implementación en Azure
Esta plantilla crea una factoría de datos V2 que copia los datos de una carpeta de Azure Blob Storage en otra carpeta del almacenamiento.
implementación de la base de datos de Azure Data Explorer con de conexión de Event Grid

Implementación en Azure
Implemente la base de datos de Azure Data Explorer con la conexión de Event Grid.
Creación de un trabajo de barrido de Azure Machine Learning

Implementación en Azure
Esta plantilla crea un trabajo de barrido de Azure Machine Learning para el ajuste de hiperparámetros.
Crear una cuenta de Azure Storage y un contenedor de blobs en Azure

Implementación en Azure
Esta plantilla crea una cuenta de Azure Storage y un contenedor de blobs.
cuenta de almacenamiento con la directiva de retención de eliminación de blobs y SSE

Implementación en Azure
Esta plantilla crea una cuenta de almacenamiento con Storage Service Encryption y una directiva de retención de eliminación de blobs.
Creación de una cuenta de almacenamiento con varios contenedores de blobs

Implementación en Azure
Crea una cuenta de Azure Storage y varios contenedores de blobs.

Definición de recursos de plantilla de ARM

El tipo de recurso storageAccounts/blobServices se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Storage/storageAccounts/blobServices, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Storage/storageAccounts/blobServices",
  "apiVersion": "2023-05-01",
  "name": "default",
  "properties": {
    "automaticSnapshotPolicyEnabled": "bool",
    "changeFeed": {
      "enabled": "bool",
      "retentionInDays": "int"
    },
    "containerDeleteRetentionPolicy": {
      "allowPermanentDelete": "bool",
      "days": "int",
      "enabled": "bool"
    },
    "cors": {
      "corsRules": [
        {
          "allowedHeaders": [ "string" ],
          "allowedMethods": [ "string" ],
          "allowedOrigins": [ "string" ],
          "exposedHeaders": [ "string" ],
          "maxAgeInSeconds": "int"
        }
      ]
    },
    "defaultServiceVersion": "string",
    "deleteRetentionPolicy": {
      "allowPermanentDelete": "bool",
      "days": "int",
      "enabled": "bool"
    },
    "isVersioningEnabled": "bool",
    "lastAccessTimeTrackingPolicy": {
      "blobType": [ "string" ],
      "enable": "bool",
      "name": "AccessTimeTracking",
      "trackingGranularityInDays": "int"
    },
    "restorePolicy": {
      "days": "int",
      "enabled": "bool"
    }
  }
}

Valores de propiedad

storageAccounts/blobServices

Nombre Descripción Valor
tipo El tipo de recurso 'Microsoft.Storage/storageAccounts/blobServices'
apiVersion La versión de la API de recursos '2023-05-01'
nombre El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM json.
'default'
Propiedades Propiedades de Blob service de una cuenta de almacenamiento. BlobServicePropertiesProperties

BlobServicePropertiesPropertiesProperties

Nombre Descripción Valor
automaticSnapshotPolicyEnabled En desuso en favor de la propiedad isVersioningEnabled. Bool
changeFeed Propiedades de Blob service para eventos de fuente de cambios. ChangeFeed
containerDeleteRetentionPolicy Las propiedades de Blob Service para la eliminación temporal del contenedor. DeleteRetentionPolicy
cors Especifica 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. corsRules
defaultServiceVersion DefaultServiceVersion indica la versión predeterminada que se va a usar para las solicitudes a Blob service 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. cuerda
deleteRetentionPolicy Las propiedades de Blob Service para la eliminación temporal de blobs. DeleteRetentionPolicy
isVersioningEnabled El control de versiones está habilitado si se establece en true. Bool
lastAccessTimeTrackingPolicy La propiedad blob service para configurar la directiva de seguimiento basada en la hora de último acceso. LastAccessTimeTrackingPolicy
restorePolicy Las propiedades de Blob Service para la directiva de restauración de blobs. restorePolicyProperties

ChangeFeed

Nombre Descripción Valor
Habilitado Indica si el registro de eventos de fuente de cambios está habilitado para Blob service. Bool
retentionInDays Indica la duración de la retención changeFeed en días. El valor mínimo es 1 día y el valor máximo es 146000 días (400 años). Un valor NULL indica una retención infinita de la fuente de cambios. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 146000

DeleteRetentionPolicy

Nombre Descripción Valor
allowPermanentDelete Esta propiedad cuando se establece en true permite la eliminación de las versiones y instantáneas del blob eliminado 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. Bool
Días 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. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 365
Habilitado Indica si DeleteRetentionPolicy está habilitado. Bool

CorsRules

Nombre Descripción Valor
corsRules Lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud. corsRule[]

CorsRule

Nombre Descripción Valor
allowedHeaders Obligatorio si el elemento CorsRule está presente. Lista de encabezados que pueden formar parte de la solicitud entre orígenes. string[] (obligatorio)
allowedMethods Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen permite ejecutar. Matriz de cadenas que contiene cualquiera de:
'CONNECT'
'DELETE'
'GET'
'HEAD'
'MERGE'
'OPTIONS'
'PATCH'
'POST'
'PUT'
'TRACE' (obligatorio)
allowedOrigins 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 string[] (obligatorio)
exposedHeaders Obligatorio si el elemento CorsRule está presente. Lista de encabezados de respuesta que se van a exponer a los clientes CORS. string[] (obligatorio)
maxAgeInSeconds Obligatorio si el elemento CorsRule está presente. Número de segundos que el cliente o explorador debe almacenar en caché una respuesta preparatoria. int (obligatorio)

LastAccessTimeTrackingPolicy

Nombre Descripción Valor
blobType Matriz de tipos de blobs admitidos predefinidos. Solo blockBlob es el valor admitido. Este campo es actualmente de solo lectura string[]
habilitar Cuando se establece en true, se habilita el seguimiento basado en la hora del último acceso. bool (obligatorio)
nombre Nombre de la directiva. El valor válido es AccessTimeTracking. Este campo es actualmente de solo lectura "AccessTimeTracking"
trackingGranularityInDays El campo especifica la granularidad de seguimiento de objetos de blob en días, normalmente la frecuencia con la que se debe realizar el seguimiento del objeto de blob. Este campo es actualmente de solo lectura con el valor 1 Int

RestorePolicyProperties

Nombre Descripción Valor
Días cuánto tiempo se puede restaurar este blob. Debe ser grande que cero y menor que DeleteRetentionPolicy.days. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 365
Habilitado La restauración de blobs está habilitada si se establece en true. bool (obligatorio)

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Azure Cloud Shell: de almacenamiento de red virtual

Implementación en Azure
Esta plantilla implementa el almacenamiento de Azure Cloud Shell en una red virtual de Azure.
Crear una de factoría de datos V2

Implementación en Azure
Esta plantilla crea una factoría de datos V2 que copia los datos de una carpeta de Azure Blob Storage en otra carpeta del almacenamiento.
implementación de la base de datos de Azure Data Explorer con de conexión de Event Grid

Implementación en Azure
Implemente la base de datos de Azure Data Explorer con la conexión de Event Grid.
Creación de un trabajo de barrido de Azure Machine Learning

Implementación en Azure
Esta plantilla crea un trabajo de barrido de Azure Machine Learning para el ajuste de hiperparámetros.
Crear una cuenta de Azure Storage y un contenedor de blobs en Azure

Implementación en Azure
Esta plantilla crea una cuenta de Azure Storage y un contenedor de blobs.
cuenta de almacenamiento con la directiva de retención de eliminación de blobs y SSE

Implementación en Azure
Esta plantilla crea una cuenta de almacenamiento con Storage Service Encryption y una directiva de retención de eliminación de blobs.
Creación de una cuenta de almacenamiento con varios contenedores de blobs

Implementación en Azure
Crea una cuenta de Azure Storage y varios contenedores de blobs.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso storageAccounts/blobServices se puede implementar con operaciones que tienen como destino:

  • grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Storage/storageAccounts/blobServices, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Storage/storageAccounts/blobServices@2023-05-01"
  name = "default"
  parent_id = "string"
  body = jsonencode({
    properties = {
      automaticSnapshotPolicyEnabled = bool
      changeFeed = {
        enabled = bool
        retentionInDays = int
      }
      containerDeleteRetentionPolicy = {
        allowPermanentDelete = bool
        days = int
        enabled = bool
      }
      cors = {
        corsRules = [
          {
            allowedHeaders = [
              "string"
            ]
            allowedMethods = [
              "string"
            ]
            allowedOrigins = [
              "string"
            ]
            exposedHeaders = [
              "string"
            ]
            maxAgeInSeconds = int
          }
        ]
      }
      defaultServiceVersion = "string"
      deleteRetentionPolicy = {
        allowPermanentDelete = bool
        days = int
        enabled = bool
      }
      isVersioningEnabled = bool
      lastAccessTimeTrackingPolicy = {
        blobType = [
          "string"
        ]
        enable = bool
        name = "AccessTimeTracking"
        trackingGranularityInDays = int
      }
      restorePolicy = {
        days = int
        enabled = bool
      }
    }
  })
}

Valores de propiedad

storageAccounts/blobServices

Nombre Descripción Valor
tipo El tipo de recurso "Microsoft.Storage/storageAccounts/blobServices@2023-05-01"
nombre El nombre del recurso "valor predeterminado"
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: storageAccounts
Propiedades Propiedades de Blob service de una cuenta de almacenamiento. BlobServicePropertiesProperties

BlobServicePropertiesPropertiesProperties

Nombre Descripción Valor
automaticSnapshotPolicyEnabled En desuso en favor de la propiedad isVersioningEnabled. Bool
changeFeed Propiedades de Blob service para eventos de fuente de cambios. ChangeFeed
containerDeleteRetentionPolicy Las propiedades de Blob Service para la eliminación temporal del contenedor. DeleteRetentionPolicy
cors Especifica 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. corsRules
defaultServiceVersion DefaultServiceVersion indica la versión predeterminada que se va a usar para las solicitudes a Blob service 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. cuerda
deleteRetentionPolicy Las propiedades de Blob Service para la eliminación temporal de blobs. DeleteRetentionPolicy
isVersioningEnabled El control de versiones está habilitado si se establece en true. Bool
lastAccessTimeTrackingPolicy La propiedad blob service para configurar la directiva de seguimiento basada en la hora de último acceso. LastAccessTimeTrackingPolicy
restorePolicy Las propiedades de Blob Service para la directiva de restauración de blobs. restorePolicyProperties

ChangeFeed

Nombre Descripción Valor
Habilitado Indica si el registro de eventos de fuente de cambios está habilitado para Blob service. Bool
retentionInDays Indica la duración de la retención changeFeed en días. El valor mínimo es 1 día y el valor máximo es 146000 días (400 años). Un valor NULL indica una retención infinita de la fuente de cambios. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 146000

DeleteRetentionPolicy

Nombre Descripción Valor
allowPermanentDelete Esta propiedad cuando se establece en true permite la eliminación de las versiones y instantáneas del blob eliminado 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. Bool
Días 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. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 365
Habilitado Indica si DeleteRetentionPolicy está habilitado. Bool

CorsRules

Nombre Descripción Valor
corsRules Lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud. corsRule[]

CorsRule

Nombre Descripción Valor
allowedHeaders Obligatorio si el elemento CorsRule está presente. Lista de encabezados que pueden formar parte de la solicitud entre orígenes. string[] (obligatorio)
allowedMethods Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen permite ejecutar. Matriz de cadenas que contiene cualquiera de:
"CONNECT"
"DELETE"
"GET"
"HEAD"
"MERGE"
"OPCIONES"
"PATCH"
"POST"
"PUT"
"TRACE" (obligatorio)
allowedOrigins 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 string[] (obligatorio)
exposedHeaders Obligatorio si el elemento CorsRule está presente. Lista de encabezados de respuesta que se van a exponer a los clientes CORS. string[] (obligatorio)
maxAgeInSeconds Obligatorio si el elemento CorsRule está presente. Número de segundos que el cliente o explorador debe almacenar en caché una respuesta preparatoria. int (obligatorio)

LastAccessTimeTrackingPolicy

Nombre Descripción Valor
blobType Matriz de tipos de blobs admitidos predefinidos. Solo blockBlob es el valor admitido. Este campo es actualmente de solo lectura string[]
habilitar Cuando se establece en true, se habilita el seguimiento basado en la hora del último acceso. bool (obligatorio)
nombre Nombre de la directiva. El valor válido es AccessTimeTracking. Este campo es actualmente de solo lectura "AccessTimeTracking"
trackingGranularityInDays El campo especifica la granularidad de seguimiento de objetos de blob en días, normalmente la frecuencia con la que se debe realizar el seguimiento del objeto de blob. Este campo es actualmente de solo lectura con el valor 1 Int

RestorePolicyProperties

Nombre Descripción Valor
Días cuánto tiempo se puede restaurar este blob. Debe ser grande que cero y menor que DeleteRetentionPolicy.days. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 365
Habilitado La restauración de blobs está habilitada si se establece en true. bool (obligatorio)