Compartilhar via


Blob Services - Set Service Properties

Define as propriedades do serviço Blob de uma conta de armazenamento, incluindo propriedades para regras de Análise de Armazenamento e CORS (Cross-Origin Resource Sharing).

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2023-05-01

Parâmetros do URI

Name Em Necessário Tipo Description
accountName
path True

string

O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes das contas de armazenamento devem ter entre 3 e 24 caracteres e usar apenas números e letras minúsculas.

Padrão Regex: ^[a-z0-9]+$

BlobServicesName
path True

BlobServicesName

O nome do serviço de blob na conta de armazenamento especificada. O Nome do Serviço de Blob deve ser 'padrão'

resourceGroupName
path True

string

O nome do grupo de recursos dentro da assinatura do usuário. O nome não diferencia maiúsculas de minúsculas.

Padrão Regex: ^[-\w\._\(\)]+$

subscriptionId
path True

string

A ID da assinatura de destino.

api-version
query True

string

A versão da API a ser usada para esta operação.

Corpo do Pedido

Name Tipo Description
properties.automaticSnapshotPolicyEnabled

boolean

Preterido em favor da propriedade isVersioningEnabled.

properties.changeFeed

ChangeFeed

As propriedades do serviço de blob para eventos de feed de alteração.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

As propriedades do serviço de blob para exclusão suave de contêiner.

properties.cors

CorsRules

Especifica regras CORS para o serviço Blob. Você pode incluir até cinco elementos CorsRule na solicitação. Se nenhum elemento CorsRule for incluído no corpo da solicitação, todas as regras do CORS serão excluídas e o CORS será desabilitado para o serviço Blob.

properties.defaultServiceVersion

string

DefaultServiceVersion indica a versão padrão a ser usada para solicitações ao serviço Blob se a versão de uma solicitação de entrada não for especificada. Os valores possíveis incluem a versão 2008-10-27 e todas as versões mais recentes.

properties.deleteRetentionPolicy

DeleteRetentionPolicy

As propriedades do serviço de blob para exclusão suave de blob.

properties.isVersioningEnabled

boolean

O controle de versão é habilitado se definido como true.

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

A propriedade de serviço de blob para configurar a política de rastreamento baseada no tempo do último acesso.

properties.restorePolicy

RestorePolicyProperties

As propriedades do serviço de blob para a política de restauração de blob.

Respostas

Name Tipo Description
200 OK

BlobServiceProperties

OK -- Define as propriedades do serviço de Blob de uma conta de armazenamento com êxito.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

BlobServicesPutAllowPermanentDelete
BlobServicesPutLastAccessTimeBasedTracking
PutBlobServices

BlobServicesPutAllowPermanentDelete

Pedido de amostra

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2023-05-01

{
  "properties": {
    "deleteRetentionPolicy": {
      "enabled": true,
      "days": 300,
      "allowPermanentDelete": true
    },
    "isVersioningEnabled": true
  }
}

Resposta da amostra

{
  "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

Pedido de amostra

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2023-05-01

{
  "properties": {
    "lastAccessTimeTrackingPolicy": {
      "enable": true,
      "name": "AccessTimeTracking",
      "trackingGranularityInDays": 1,
      "blobType": [
        "blockBlob"
      ]
    }
  }
}

Resposta da amostra

{
  "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

Pedido de amostra

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2023-05-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
    }
  }
}

Resposta da amostra

{
  "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"
  }
}

Definições

Name Description
AllowedMethods

Obrigatório se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que podem ser executados pela origem.

BlobServiceProperties

As propriedades do serviço de Blob de uma conta de armazenamento.

BlobServicesName

O nome do serviço de blob na conta de armazenamento especificada. O Nome do Serviço de Blob deve ser 'padrão'

ChangeFeed

As propriedades do serviço de blob para eventos de feed de alteração.

CorsRule

Especifica uma regra CORS para o serviço Blob.

CorsRules

Define as regras do CORS. Você pode incluir até cinco elementos CorsRule na solicitação.

DeleteRetentionPolicy

As propriedades de serviço para exclusão suave.

LastAccessTimeTrackingPolicy

As propriedades do serviço de blob para a política de rastreamento baseada em tempo de último acesso.

name

Nome da política. O valor válido é AccessTimeTracking. Este campo é atualmente somente leitura

RestorePolicyProperties

As propriedades do serviço de blob para a política de restauração de blob

Sku

O SKU da conta de armazenamento.

SkuName

O nome SKU. Necessário para a criação de conta; opcional para atualização. Observe que, em versões mais antigas, o nome da SKU era chamado accountType.

SkuTier

A camada de SKU. Isso é baseado no nome SKU.

AllowedMethods

Obrigatório se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que podem ser executados pela origem.

Name Tipo Description
CONNECT

string

DELETE

string

GET

string

HEAD

string

MERGE

string

OPTIONS

string

PATCH

string

POST

string

PUT

string

TRACE

string

BlobServiceProperties

As propriedades do serviço de Blob de uma conta de armazenamento.

Name Tipo Description
id

string

ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

O nome do recurso

properties.automaticSnapshotPolicyEnabled

boolean

Preterido em favor da propriedade isVersioningEnabled.

properties.changeFeed

ChangeFeed

As propriedades do serviço de blob para eventos de feed de alteração.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

As propriedades do serviço de blob para exclusão suave de contêiner.

properties.cors

CorsRules

Especifica regras CORS para o serviço Blob. Você pode incluir até cinco elementos CorsRule na solicitação. Se nenhum elemento CorsRule for incluído no corpo da solicitação, todas as regras do CORS serão excluídas e o CORS será desabilitado para o serviço Blob.

properties.defaultServiceVersion

string

DefaultServiceVersion indica a versão padrão a ser usada para solicitações ao serviço Blob se a versão de uma solicitação de entrada não for especificada. Os valores possíveis incluem a versão 2008-10-27 e todas as versões mais recentes.

properties.deleteRetentionPolicy

DeleteRetentionPolicy

As propriedades do serviço de blob para exclusão suave de blob.

properties.isVersioningEnabled

boolean

O controle de versão é habilitado se definido como true.

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

A propriedade de serviço de blob para configurar a política de rastreamento baseada no tempo do último acesso.

properties.restorePolicy

RestorePolicyProperties

As propriedades do serviço de blob para a política de restauração de blob.

sku

Sku

Nome e camada da Sku.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

BlobServicesName

O nome do serviço de blob na conta de armazenamento especificada. O Nome do Serviço de Blob deve ser 'padrão'

Name Tipo Description
default

string

ChangeFeed

As propriedades do serviço de blob para eventos de feed de alteração.

Name Tipo Description
enabled

boolean

Indica se o log de eventos do feed de alterações está habilitado para o serviço Blob.

retentionInDays

integer

Indica a duração da retenção changeFeed em dias. O valor mínimo é de 1 dia e o valor máximo é de 146000 dias (400 anos). Um valor nulo indica uma retenção infinita do feed de alterações.

CorsRule

Especifica uma regra CORS para o serviço Blob.

Name Tipo Description
allowedHeaders

string[]

Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos que podem fazer parte da solicitação de origem cruzada.

allowedMethods

AllowedMethods[]

Obrigatório se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que podem ser executados pela origem.

allowedOrigins

string[]

Obrigatório se o elemento CorsRule estiver presente. Uma lista de domínios de origem que serão permitidos via CORS, ou "*" para permitir todos os domínios

exposedHeaders

string[]

Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos de resposta para expor aos clientes CORS.

maxAgeInSeconds

integer

Obrigatório se o elemento CorsRule estiver presente. O número de segundos que o cliente/navegador deve armazenar em cache uma resposta de comprovação.

CorsRules

Define as regras do CORS. Você pode incluir até cinco elementos CorsRule na solicitação.

Name Tipo Description
corsRules

CorsRule[]

A lista de regras do CORS. Você pode incluir até cinco elementos CorsRule na solicitação.

DeleteRetentionPolicy

As propriedades de serviço para exclusão suave.

Name Tipo Description
allowPermanentDelete

boolean

Esta propriedade, quando definida como true, permite a exclusão das versões e instantâneos de blob excluídos suavemente. Esta propriedade não pode ser usada política de restauração de blob. Essa propriedade só se aplica ao serviço de blob e não se aplica a contêineres ou compartilhamento de arquivos.

days

integer

Indica o número de dias em que o item excluído deve ser mantido. O valor mínimo especificado pode ser 1 e o valor máximo pode ser 365.

enabled

boolean

Indica se DeleteRetentionPolicy está habilitado.

LastAccessTimeTrackingPolicy

As propriedades do serviço de blob para a política de rastreamento baseada em tempo de último acesso.

Name Tipo Description
blobType

string[]

Uma matriz de tipos de blob suportados predefinidos. Apenas blockBlob é o valor suportado. Este campo é atualmente somente leitura

enable

boolean

Quando definido como verdadeiro, o rastreamento baseado no tempo do último acesso está habilitado.

name

name

Nome da política. O valor válido é AccessTimeTracking. Este campo é atualmente somente leitura

trackingGranularityInDays

integer

O campo especifica a granularidade do rastreamento do objeto blob em dias, normalmente a frequência com que o objeto blob deve ser rastreado. Atualmente, este campo é lido apenas com o valor 1

name

Nome da política. O valor válido é AccessTimeTracking. Este campo é atualmente somente leitura

Name Tipo Description
AccessTimeTracking

string

RestorePolicyProperties

As propriedades do serviço de blob para a política de restauração de blob

Name Tipo Description
days

integer

por quanto tempo este blob pode ser restaurado. Deve ser ótimo que zero e menor que DeleteRetentionPolicy.days.

enabled

boolean

A restauração de Blob será habilitada se definida como true.

lastEnabledTime

string

Preterido em favor da propriedade minRestoreTime.

minRestoreTime

string

Retorna a data e a hora mínimas em que a restauração pode ser iniciada.

Sku

O SKU da conta de armazenamento.

Name Tipo Description
name

SkuName

O nome SKU. Necessário para a criação de conta; opcional para atualização. Observe que, em versões mais antigas, o nome da SKU era chamado accountType.

tier

SkuTier

A camada de SKU. Isso é baseado no nome SKU.

SkuName

O nome SKU. Necessário para a criação de conta; opcional para atualização. Observe que, em versões mais antigas, o nome da SKU era chamado accountType.

Name 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

A camada de SKU. Isso é baseado no nome SKU.

Name Tipo Description
Premium

string

Standard

string