Blob Containers - Update

Aggiorna le proprietà del contenitore come specificato nel corpo della richiesta. Le proprietà non indicate nella richiesta verranno invariate. L'aggiornamento non riesce se il contenitore specificato non esiste già.

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

Parametri dell'URI

Name In Required Type Description
accountName
path True
  • string

Nome dell'account di archiviazione all'interno del gruppo di risorse specificato. I nomi degli account di archiviazione devono essere di lunghezza compresa tra 3 e 24 caratteri e utilizzare solo numeri e lettere minuscole.

containerName
path True
  • string

Nome del contenitore BLOB all'interno dell'account di archiviazione specificato. I nomi dei contenitori BLOB devono essere compresi tra 3 e 63 caratteri di lunghezza e usare numeri, lettere minuscole e trattini (-). Ogni carattere trattino (-) deve essere immediatamente preceduto e seguito da una lettera o un numero.

resourceGroupName
path True
  • string

Nome del gruppo di risorse all'interno della sottoscrizione dell'utente. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True
  • string

ID della sottoscrizione di destinazione.

api-version
query True
  • string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Name Type Description
properties.defaultEncryptionScope
  • string

Impostazione predefinita del contenitore per l'uso dell'ambito di crittografia specificato per tutte le scritture.

properties.denyEncryptionScopeOverride
  • boolean

Bloccare l'override dell'ambito di crittografia dal contenitore predefinito.

properties.enableNfsV3AllSquash
  • boolean

Abilitare NFSv3 tutti gli squash nel contenitore BLOB.

properties.enableNfsV3RootSquash
  • boolean

Abilitare lo squash radice NFSv3 nel contenitore BLOB.

properties.immutableStorageWithVersioning

Proprietà non modificabile a livello di oggetto del contenitore. La proprietà è non modificabile e può essere impostata solo su true al momento della creazione del contenitore. I contenitori esistenti devono eseguire un processo di migrazione.

properties.metadata
  • object

Coppia nome-valore da associare al contenitore come metadati.

properties.publicAccess

Specifica se i dati nel contenitore sono accessibili pubblicamente e il livello di accesso.

Risposte

Name Type Description
200 OK

OK - Aggiornare l'operazione contenitore completata correttamente.

Sicurezza

azure_auth

Azure Active Directory Flow OAuth2

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

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

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

Definizioni

BlobContainer

Proprietà del contenitore BLOB, tra cui ID, nome risorsa, tipo di risorsa, Etag.

ImmutabilityPolicyProperties

Proprietà di un oggetto ImmutabilityPolicy di un contenitore BLOB.

ImmutabilityPolicyState

Lo stato ImmutabilityPolicy di un contenitore BLOB, i valori possibili includono: Bloccato e Sbloccato.

ImmutabilityPolicyUpdateType

Il tipo di aggiornamento ImmutabilityPolicy di un contenitore BLOB, i valori possibili includono: put, lock ed extend.

ImmutableStorageWithVersioning

Proprietà di non modificabilità a livello di oggetto del contenitore.

LeaseDuration

Specifica se il lease in un contenitore è di durata infinita o fissa, solo quando il contenitore viene eseguito il lease.

LeaseState

Stato del lease del contenitore.

LeaseStatus

Stato del lease del contenitore.

LegalHoldProperties

Proprietà LegalHold di un contenitore BLOB.

MigrationState

Questa proprietà indica l'immutabilità a livello di contenitore per lo stato di migrazione non modificabile a livello di oggetto.

ProtectedAppendWritesHistory

Impostazione della cronologia di scrittura accodamento protetta per il contenitore BLOB con i blocchi legali.

PublicAccess

Specifica se i dati nel contenitore sono accessibili pubblicamente e il livello di accesso.

TagProperty

Tag di LegalHold di un contenitore BLOB.

UpdateHistoryProperty

Cronologia degli aggiornamenti di ImmutabilityPolicy di un contenitore BLOB.

BlobContainer

Proprietà del contenitore BLOB, tra cui ID, nome risorsa, tipo di risorsa, Etag.

Name Type Description
etag
  • string

Resource Etag.

id
  • string

ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

nome della risorsa.

properties.defaultEncryptionScope
  • string

Impostazione predefinita del contenitore per l'uso dell'ambito di crittografia specificato per tutte le scritture.

properties.deleted
  • boolean

Indica se il contenitore BLOB è stato eliminato.

properties.deletedTime
  • string

Tempo di eliminazione del contenitore BLOB.

properties.denyEncryptionScopeOverride
  • boolean

Bloccare l'override dell'ambito di crittografia dal contenitore predefinito.

properties.enableNfsV3AllSquash
  • boolean

Abilitare NFSv3 tutti gli squash nel contenitore BLOB.

properties.enableNfsV3RootSquash
  • boolean

Abilitare lo squash radice NFSv3 nel contenitore BLOB.

properties.hasImmutabilityPolicy
  • boolean

La proprietà pubblica hasImmutabilityPolicy è impostata su true da SRP se ImmutabilityPolicy è stata creata per questo contenitore. La proprietà pubblica hasImmutabilityPolicy è impostata su false da SRP se ImmutabilityPolicy non è stato creato per questo contenitore.

properties.hasLegalHold
  • boolean

La proprietà pubblica hasLegalHold è impostata su true da SRP se sono presenti almeno un tag esistente. La proprietà pubblica hasLegalHold è impostata su false da SRP se tutti i tag di blocco legali esistenti vengono cancellati. È possibile che siano presenti un massimo di 1000 contenitori BLOB con hasLegalHold=true per un determinato account.

properties.immutabilityPolicy

Proprietà ImmutabilityPolicy del contenitore.

properties.immutableStorageWithVersioning

Proprietà non modificabile a livello di oggetto del contenitore. La proprietà è non modificabile e può essere impostata solo su true al momento della creazione del contenitore. I contenitori esistenti devono eseguire un processo di migrazione.

properties.lastModifiedTime
  • string

Restituisce la data e l'ora dell'ultima modifica apportata al contenitore.

properties.leaseDuration

Specifica se il lease in un contenitore è di durata infinita o fissa, solo quando il contenitore viene eseguito il lease.

properties.leaseState

Stato del lease del contenitore.

properties.leaseStatus

Stato del lease del contenitore.

properties.legalHold

Proprietà LegalHold del contenitore.

properties.metadata
  • object

Coppia nome-valore da associare al contenitore come metadati.

properties.publicAccess

Specifica se i dati nel contenitore sono accessibili pubblicamente e il livello di accesso.

properties.remainingRetentionDays
  • integer

Giorni di conservazione rimanenti per il contenitore BLOB eliminato temporanea.

properties.version
  • string

Versione del contenitore BLOB eliminato.

type
  • string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft. Archiviazione/storageAccounts"

ImmutabilityPolicyProperties

Proprietà di un oggetto ImmutabilityPolicy di un contenitore BLOB.

Name Type Description
etag
  • string

ImmutabilityPolicy Etag.

properties.allowProtectedAppendWrites
  • boolean

Questa proprietà può essere modificata solo per i criteri di conservazione basati sul tempo sbloccati. Se abilitato, i nuovi blocchi possono essere scritti in un BLOB di accodamento mantenendo la protezione e la conformità non modificabili. È possibile aggiungere solo nuovi blocchi ed eventuali blocchi esistenti non possono essere modificati o eliminati. Questa proprietà non può essere modificata con l'API ExtendImmutabilityPolicy.

properties.allowProtectedAppendWritesAll
  • boolean

Questa proprietà può essere modificata solo per i criteri di conservazione basati sul tempo sbloccati. Se abilitata, i nuovi blocchi possono essere scritti in "Accodamento e BLOB bock" mantenendo la protezione e la conformità non modificabili. È possibile aggiungere solo nuovi blocchi ed eventuali blocchi esistenti non possono essere modificati o eliminati. Questa proprietà non può essere modificata con l'API ExtendImmutabilityPolicy. Le proprietà 'allowProtectedAppendWrites' e 'allowProtectedAppendWritesAll' si escludono a vicenda.

properties.immutabilityPeriodSinceCreationInDays
  • integer

Periodo di immutabilità per i BLOB nel contenitore dopo la creazione dei criteri, in giorni.

properties.state

Lo stato ImmutabilityPolicy di un contenitore BLOB, i valori possibili includono: Bloccato e Sbloccato.

updateHistory

Cronologia degli aggiornamenti ImmutabilityPolicy del contenitore BLOB.

ImmutabilityPolicyState

Lo stato ImmutabilityPolicy di un contenitore BLOB, i valori possibili includono: Bloccato e Sbloccato.

Name Type Description
Locked
  • string
Unlocked
  • string

ImmutabilityPolicyUpdateType

Il tipo di aggiornamento ImmutabilityPolicy di un contenitore BLOB, i valori possibili includono: put, lock ed extend.

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

ImmutableStorageWithVersioning

Proprietà di non modificabilità a livello di oggetto del contenitore.

Name Type Description
enabled
  • boolean

Si tratta di una proprietà non modificabile, se impostata su true, consente l'immutabilità a livello di oggetto a livello di contenitore.

migrationState

Questa proprietà indica l'immutabilità a livello di contenitore per lo stato di migrazione non modificabile a livello di oggetto.

timeStamp
  • string

Restituisce la data e l'ora in cui è stata abilitata l'immutabilità del livello di oggetto.

LeaseDuration

Specifica se il lease in un contenitore è di durata infinita o fissa, solo quando il contenitore viene eseguito il lease.

Name Type Description
Fixed
  • string
Infinite
  • string

LeaseState

Stato del lease del contenitore.

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

LeaseStatus

Stato del lease del contenitore.

Name Type Description
Locked
  • string
Unlocked
  • string

LegalHoldProperties

Proprietà LegalHold di un contenitore BLOB.

Name Type Description
hasLegalHold
  • boolean

La proprietà pubblica hasLegalHold è impostata su true da SRP se sono presenti almeno un tag esistente. La proprietà pubblica hasLegalHold è impostata su false da SRP se tutti i tag di blocco legali esistenti vengono cancellati. È possibile che siano presenti un massimo di 1000 contenitori BLOB con hasLegalHold=true per un determinato account.

protectedAppendWritesHistory

Cronologia delle scritture BLOB accodamento protette.

tags

Elenco di tag LegalHold di un contenitore BLOB.

MigrationState

Questa proprietà indica l'immutabilità a livello di contenitore per lo stato di migrazione non modificabile a livello di oggetto.

Name Type Description
Completed
  • string
InProgress
  • string

ProtectedAppendWritesHistory

Impostazione della cronologia di scrittura accodamento protetta per il contenitore BLOB con i blocchi legali.

Name Type Description
allowProtectedAppendWritesAll
  • boolean

Se abilitato, i nuovi blocchi possono essere scritti in "Accodamento e BLOB bock" mantenendo la protezione e la conformità legali. È possibile aggiungere solo nuovi blocchi ed eventuali blocchi esistenti non possono essere modificati o eliminati.

timestamp
  • string

Restituisce la data e l'ora di aggiunta del tag.

PublicAccess

Specifica se i dati nel contenitore sono accessibili pubblicamente e il livello di accesso.

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

TagProperty

Tag di LegalHold di un contenitore BLOB.

Name Type Description
objectIdentifier
  • string

Restituisce l'ID oggetto dell'utente che ha aggiunto il tag.

tag
  • string

Il valore del tag.

tenantId
  • string

Restituisce l'ID tenant che ha rilasciato il token per l'utente che ha aggiunto il tag.

timestamp
  • string

Restituisce la data e l'ora di aggiunta del tag.

upn
  • string

Restituisce il nome dell'entità utente dell'utente che ha aggiunto il tag.

UpdateHistoryProperty

Cronologia degli aggiornamenti di ImmutabilityPolicy di un contenitore BLOB.

Name Type Description
allowProtectedAppendWrites
  • boolean

Questa proprietà può essere modificata solo per i criteri di conservazione basati sul tempo sbloccati. Se abilitato, i nuovi blocchi possono essere scritti in un BLOB di accodamento mantenendo la protezione e la conformità non modificabili. È possibile aggiungere solo nuovi blocchi ed eventuali blocchi esistenti non possono essere modificati o eliminati. Questa proprietà non può essere modificata con l'API ExtendImmutabilityPolicy.

allowProtectedAppendWritesAll
  • boolean

Questa proprietà può essere modificata solo per i criteri di conservazione basati sul tempo sbloccati. Se abilitata, i nuovi blocchi possono essere scritti in "Accodamento e BLOB bock" mantenendo la protezione e la conformità non modificabili. È possibile aggiungere solo nuovi blocchi ed eventuali blocchi esistenti non possono essere modificati o eliminati. Questa proprietà non può essere modificata con l'API ExtendImmutabilityPolicy. Le proprietà 'allowProtectedAppendWrites' e 'allowProtectedAppendWritesAll' si escludono a vicenda.

immutabilityPeriodSinceCreationInDays
  • integer

Periodo di immutabilità per i BLOB nel contenitore dopo la creazione dei criteri, in giorni.

objectIdentifier
  • string

Restituisce l'ID oggetto dell'utente che ha aggiornato ImmutabilityPolicy.

tenantId
  • string

Restituisce l'ID tenant che ha rilasciato il token per l'utente che ha aggiornato ImmutabilityPolicy.

timestamp
  • string

Restituisce la data e l'ora dell'aggiornamento di ImmutabilityPolicy.

update

Il tipo di aggiornamento ImmutabilityPolicy di un contenitore BLOB, i valori possibili includono: put, lock ed extend.

upn
  • string

Restituisce il nome dell'entità utente dell'utente che ha aggiornato ImmutabilityPolicy.