Blob Containers - Update

Atualiza as propriedades do contêiner conforme especificado no corpo da solicitação. As propriedades não mencionadas na solicitação serão inalteradas. A atualização falhará se o contêiner especificado ainda não existir.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default/containers/{containerName}?api-version=2021-09-01

Parâmetros de URI

Name In Required Type Description
accountName
path True
  • string

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

containerName
path True
  • string

O nome do contêiner de blob dentro da conta de armazenamento especificada. Os nomes de contêiner de blob devem ter entre 3 e 63 caracteres de comprimento e usar números, letras minúsculas e traço (-) somente. Todo caractere de traço (-) precisa ser precedido e seguido imediatamente por uma letra ou um número.

resourceGroupName
path True
  • string

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

Regex pattern: ^[-\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 essa operação.

Corpo da solicitação

Name Type Description
properties.defaultEncryptionScope
  • string

Padrão, o contêiner usará o escopo de criptografia especificado para todas as gravações.

properties.denyEncryptionScopeOverride
  • boolean

Bloquear a substituição do escopo de criptografia do padrão do contêiner.

properties.enableNfsV3AllSquash
  • boolean

Habilite todo o squash NFSv3 no contêiner de blob.

properties.enableNfsV3RootSquash
  • boolean

Habilite o squash raiz NFSv3 no contêiner de blob.

properties.immutableStorageWithVersioning

A propriedade de imutabilidade no nível do objeto do contêiner. A propriedade é imutável e só pode ser definida como true no momento da criação do contêiner. Os contêineres existentes devem passar por um processo de migração.

properties.metadata
  • object

Um par de nome-valor a ser associado ao contêiner como metadados.

properties.publicAccess

Especifica se os dados no contêiner podem ser acessados publicamente e o nível de acesso.

Respostas

Name Type Description
200 OK

OK – Atualizar a operação de contêiner concluída com êxito.

Segurança

azure_auth

Flow Azure Active Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

UpdateContainers

Sample Request

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/blobServices/default/containers/container6185?api-version=2021-09-01

{
  "properties": {
    "publicAccess": "Container",
    "metadata": {
      "metadata": "true"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/blobServices/default/containers/container6185",
  "name": "container6185",
  "type": "Microsoft.Storage/storageAccounts/blobServices/containers",
  "properties": {
    "metadata": {
      "metadata": "true"
    },
    "publicAccess": "Container",
    "hasImmutabilityPolicy": false,
    "hasLegalHold": false
  }
}

Definições

BlobContainer

Propriedades do contêiner de blob, incluindo ID, nome do recurso, tipo de recurso, Etag.

ImmutabilityPolicyProperties

As propriedades de um ImmutabilityPolicy de um contêiner de blob.

ImmutabilityPolicyState

O estado ImmutabilityPolicy de um contêiner de blob, os valores possíveis incluem: Bloqueado e Desbloqueado.

ImmutabilityPolicyUpdateType

O tipo de atualização ImmutabilityPolicy de um contêiner de blob, os valores possíveis incluem: colocar, bloquear e estender.

ImmutableStorageWithVersioning

Propriedades de imutabilidade no nível do objeto do contêiner.

LeaseDuration

Especifica se a concessão em um contêiner é de duração infinita ou fixa, somente quando o contêiner é concedido.

LeaseState

Estado da concessão do contêiner.

LeaseStatus

O status da concessão do contêiner.

LegalHoldProperties

A propriedade LegalHold de um contêiner de blob.

MigrationState

Essa propriedade denota a imutabilidade no nível do contêiner para o estado de migração de imutabilidade no nível do objeto.

ProtectedAppendWritesHistory

Configuração de histórico de gravações de acréscimo protegido para o contêiner de blob com retenções legais.

PublicAccess

Especifica se os dados no contêiner podem ser acessados publicamente e o nível de acesso.

TagProperty

Uma marca do LegalHold de um contêiner de blob.

UpdateHistoryProperty

Um histórico de atualização do ImmutabilityPolicy de um contêiner de blob.

BlobContainer

Propriedades do contêiner de blob, incluindo ID, nome do recurso, tipo de recurso, Etag.

Name Type Description
etag
  • string

Etag de recurso.

id
  • string

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

name
  • string

O nome do recurso

properties.defaultEncryptionScope
  • string

Padrão, o contêiner usará o escopo de criptografia especificado para todas as gravações.

properties.deleted
  • boolean

Indica se o contêiner de blob foi excluído.

properties.deletedTime
  • string

Hora de exclusão do contêiner de blob.

properties.denyEncryptionScopeOverride
  • boolean

Bloquear a substituição do escopo de criptografia do padrão do contêiner.

properties.enableNfsV3AllSquash
  • boolean

Habilite todo o squash NFSv3 no contêiner de blob.

properties.enableNfsV3RootSquash
  • boolean

Habilite o squash raiz NFSv3 no contêiner de blob.

properties.hasImmutabilityPolicy
  • boolean

A propriedade pública hasImmutabilityPolicy será definida como true pelo SRP se ImmutabilityPolicy tiver sido criado para esse contêiner. A propriedade pública hasImmutabilityPolicy será definida como false pelo SRP se ImmutabilityPolicy não tiver sido criado para esse contêiner.

properties.hasLegalHold
  • boolean

A propriedade pública hasLegalHold será definida como true pelo SRP se houver pelo menos uma marca existente. A propriedade pública hasLegalHold será definida como false pela SRP se todas as marcas de retenção legais existentes forem desmarcadas. Pode haver um máximo de 1000 contêineres de blob com hasLegalHold=true para uma determinada conta.

properties.immutabilityPolicy

A propriedade ImmutabilityPolicy do contêiner.

properties.immutableStorageWithVersioning

A propriedade de imutabilidade no nível do objeto do contêiner. A propriedade é imutável e só pode ser definida como true no momento da criação do contêiner. Os contêineres existentes devem passar por um processo de migração.

properties.lastModifiedTime
  • string

Retorna a data e a hora em que o contêiner foi modificado pela última vez.

properties.leaseDuration

Especifica se a concessão em um contêiner é de duração infinita ou fixa, somente quando o contêiner é concedido.

properties.leaseState

Estado da concessão do contêiner.

properties.leaseStatus

O status da concessão do contêiner.

properties.legalHold

A propriedade LegalHold do contêiner.

properties.metadata
  • object

Um par de nome-valor a ser associado ao contêiner como metadados.

properties.publicAccess

Especifica se os dados no contêiner podem ser acessados publicamente e o nível de acesso.

properties.remainingRetentionDays
  • integer

Dias de retenção restantes para o contêiner de blob excluído reversível.

properties.version
  • string

A versão do contêiner de blob excluído.

type
  • string

Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft. Armazenamento/storageAccounts"

ImmutabilityPolicyProperties

As propriedades de um ImmutabilityPolicy de um contêiner de blob.

Name Type Description
etag
  • string

ImmutabilityPolicy Etag.

properties.allowProtectedAppendWrites
  • boolean

Essa propriedade só pode ser alterada para políticas de retenção baseadas em tempo desbloqueadas. Quando habilitados, novos blocos podem ser gravados em um blob de acréscimo, mantendo a proteção e a conformidade da imutabilidade. Somente novos blocos podem ser adicionados e os blocos existentes não podem ser modificados ou excluídos. Essa propriedade não pode ser alterada com a API ExtendImmutabilityPolicy.

properties.allowProtectedAppendWritesAll
  • boolean

Essa propriedade só pode ser alterada para políticas de retenção baseadas em tempo desbloqueadas. Quando habilitados, novos blocos podem ser gravados em 'Acrescentar e Bock Blobs' mantendo a proteção e a conformidade da imutabilidade. Somente novos blocos podem ser adicionados e os blocos existentes não podem ser modificados ou excluídos. Essa propriedade não pode ser alterada com a API ExtendImmutabilityPolicy. As propriedades 'allowProtectedAppendWrites' e 'allowProtectedAppendWritesAll' são mutuamente exclusivas.

properties.immutabilityPeriodSinceCreationInDays
  • integer

O período de imutabilidade dos blobs no contêiner desde a criação da política, em dias.

properties.state

O estado ImmutabilityPolicy de um contêiner de blob, os valores possíveis incluem: Bloqueado e Desbloqueado.

updateHistory

O histórico de atualização ImmutabilityPolicy do contêiner de blob.

ImmutabilityPolicyState

O estado ImmutabilityPolicy de um contêiner de blob, os valores possíveis incluem: Bloqueado e Desbloqueado.

Name Type Description
Locked
  • string
Unlocked
  • string

ImmutabilityPolicyUpdateType

O tipo de atualização ImmutabilityPolicy de um contêiner de blob, os valores possíveis incluem: colocar, bloquear e estender.

Name Type Description
extend
  • string
lock
  • string
put
  • string

ImmutableStorageWithVersioning

Propriedades de imutabilidade no nível do objeto do contêiner.

Name Type Description
enabled
  • boolean

Essa é uma propriedade imutável, quando definida como true, permite a imutabilidade no nível do objeto no nível do contêiner.

migrationState

Essa propriedade denota a imutabilidade no nível do contêiner para o estado de migração de imutabilidade no nível do objeto.

timeStamp
  • string

Retorna a data e a hora em que a imutabilidade no nível do objeto foi habilitada.

LeaseDuration

Especifica se a concessão em um contêiner é de duração infinita ou fixa, somente quando o contêiner é concedido.

Name Type Description
Fixed
  • string
Infinite
  • string

LeaseState

Estado da concessão do contêiner.

Name Type Description
Available
  • string
Breaking
  • string
Broken
  • string
Expired
  • string
Leased
  • string

LeaseStatus

O status da concessão do contêiner.

Name Type Description
Locked
  • string
Unlocked
  • string

LegalHoldProperties

A propriedade LegalHold de um contêiner de blob.

Name Type Description
hasLegalHold
  • boolean

A propriedade pública hasLegalHold será definida como true pelo SRP se houver pelo menos uma marca existente. A propriedade pública hasLegalHold será definida como false pela SRP se todas as marcas de retenção legais existentes forem desmarcadas. Pode haver um máximo de 1000 contêineres de blob com hasLegalHold=true para uma determinada conta.

protectedAppendWritesHistory

Histórico de gravações de blob de acréscimo protegido.

tags

A lista de marcas legalhold de um contêiner de blob.

MigrationState

Essa propriedade denota a imutabilidade no nível do contêiner para o estado de migração de imutabilidade no nível do objeto.

Name Type Description
Completed
  • string
InProgress
  • string

ProtectedAppendWritesHistory

Configuração de histórico de gravações de acréscimo protegido para o contêiner de blob com retenções legais.

Name Type Description
allowProtectedAppendWritesAll
  • boolean

Quando habilitados, novos blocos podem ser gravados nos blobs "Acréscimo e Bock" mantendo a proteção de retenção legal e a conformidade. Somente novos blocos podem ser adicionados e os blocos existentes não podem ser modificados ou excluídos.

timestamp
  • string

Retorna a data e a hora em que a marca foi adicionada.

PublicAccess

Especifica se os dados no contêiner podem ser acessados publicamente e o nível de acesso.

Name Type Description
Blob
  • string
Container
  • string
None
  • string

TagProperty

Uma marca do LegalHold de um contêiner de blob.

Name Type Description
objectIdentifier
  • string

Retorna a ID do objeto do usuário que adicionou a marca.

tag
  • string

O valor da marcação.

tenantId
  • string

Retorna a ID do Locatário que emitiu o token para o usuário que adicionou a marca.

timestamp
  • string

Retorna a data e a hora em que a marca foi adicionada.

upn
  • string

Retorna o nome de entidade de usuário do usuário que adicionou a marca.

UpdateHistoryProperty

Um histórico de atualização do ImmutabilityPolicy de um contêiner de blob.

Name Type Description
allowProtectedAppendWrites
  • boolean

Essa propriedade só pode ser alterada para políticas de retenção baseadas em tempo desbloqueadas. Quando habilitados, novos blocos podem ser gravados em um blob de acréscimo, mantendo a proteção e a conformidade da imutabilidade. Somente novos blocos podem ser adicionados e os blocos existentes não podem ser modificados ou excluídos. Essa propriedade não pode ser alterada com a API ExtendImmutabilityPolicy.

allowProtectedAppendWritesAll
  • boolean

Essa propriedade só pode ser alterada para políticas de retenção baseadas em tempo desbloqueadas. Quando habilitados, novos blocos podem ser gravados em 'Acrescentar e Bock Blobs' mantendo a proteção e a conformidade da imutabilidade. Somente novos blocos podem ser adicionados e os blocos existentes não podem ser modificados ou excluídos. Essa propriedade não pode ser alterada com a API ExtendImmutabilityPolicy. As propriedades 'allowProtectedAppendWrites' e 'allowProtectedAppendWritesAll' são mutuamente exclusivas.

immutabilityPeriodSinceCreationInDays
  • integer

O período de imutabilidade dos blobs no contêiner desde a criação da política, em dias.

objectIdentifier
  • string

Retorna a ID do objeto do usuário que atualizou o ImmutabilityPolicy.

tenantId
  • string

Retorna a ID do Locatário que emitiu o token para o usuário que atualizou o ImmutabilityPolicy.

timestamp
  • string

Retorna a data e a hora em que o ImmutabilityPolicy foi atualizado.

update

O tipo de atualização ImmutabilityPolicy de um contêiner de blob, os valores possíveis incluem: colocar, bloquear e estender.

upn
  • string

Retorna o nome de entidade de usuário do usuário que atualizou o ImmutabilityPolicy.