Blob Containers - Update

Aktualisiert containereigenschaften wie im Anforderungstext angegeben. Eigenschaften, die in der Anforderung nicht erwähnt werden, bleiben unverändert. Das Update schlägt fehl, wenn der angegebene Container noch nicht vorhanden ist.

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

URI-Parameter

Name In Required Type Description
accountName
path True
  • string

Der Name des Speicherkontos innerhalb der angegebenen Ressourcengruppe. Speicherkontonamen müssen zwischen 3 und 24 Zeichen lang sein und dürfen nur Zahlen und Kleinbuchstaben enthalten.

containerName
path True
  • string

Der Name des Blobcontainers innerhalb des angegebenen Speicherkontos. Blobcontainernamen müssen zwischen 3 und 63 Zeichen lang sein und Zahlen verwenden, nur Kleinbuchstaben und Striche (-) verwenden. Jedes Strichzeichen (-) muss unmittelbar vorangestellt und gefolgt von einem Buchstaben oder einer Zahl sein.

resourceGroupName
path True
  • string

Der Name der Ressourcengruppe innerhalb des Abonnements des Benutzers. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

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

subscriptionId
path True
  • string

Hierbei handelt es sich um die ID des Zielabonnements.

api-version
query True
  • string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Type Description
properties.defaultEncryptionScope
  • string

Standardmäßig wird der Container zum Verwenden des angegebenen Verschlüsselungsbereichs für alle Schreibvorgänge verwendet.

properties.denyEncryptionScopeOverride
  • boolean

Blockieren der Außerkraftsetzung des Verschlüsselungsbereichs aus dem Containerstandard.

properties.enableNfsV3AllSquash
  • boolean

Aktivieren Sie NFSv3 alle Squash im Blob-Container.

properties.enableNfsV3RootSquash
  • boolean

Aktivieren Sie NFSv3-Stamm-Squash im Blobcontainer.

properties.immutableStorageWithVersioning

Die Unveränderlichkeitseigenschaft des Containers auf Objektebene. Die Eigenschaft ist unveränderlich und kann nur zur Containererstellungszeit auf "true" festgelegt werden. Vorhandene Container müssen einem Migrationsprozess unterzogen werden.

properties.metadata
  • object

Ein Name-Wert-Paar, das dem Container als Metadaten zugeordnet wird.

properties.publicAccess

Gibt an, ob öffentlicher Zugriff auf Daten im Container zulässig ist, und gibt die Zugriffsebene an.

Antworten

Name Type Description
200 OK

OK -- Aktualisieren des Containervorgangs wurde erfolgreich abgeschlossen.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

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

Definitionen

BlobContainer

Eigenschaften des Blobcontainers, einschließlich ID, Ressourcenname, Ressourcentyp, Etag.

ImmutabilityPolicyProperties

Die Eigenschaften einer ImmutabilityPolicy eines Blobcontainers.

ImmutabilityPolicyState

Der Status "UnveränderlichPolicy" eines Blobcontainers, mögliche Werte umfassen: Gesperrt und entsperrt.

ImmutabilityPolicyUpdateType

Der Updatetyp "ImmutabilityPolicy" eines Blobcontainers, mögliche Werte umfassen: Put, Lock and Extend.

ImmutableStorageWithVersioning

Eigenschaften des Objekts auf Unveränderlichkeit des Containers.

LeaseDuration

Gibt an, ob der Leasingvertrag für einen Container unendlich oder fest ist, nur dann, wenn der Container geleatet wird.

LeaseState

Der Leasezustand des Containers.

LeaseStatus

Der Leasestatus des Containers.

LegalHoldProperties

Die LegalHold-Eigenschaft eines Blobcontainers.

MigrationState

Diese Eigenschaft weist die Unveränderbarkeit der Containerebene auf Objektebene auf Unveränderbarkeitsmigrationsstatus zurück.

ProtectedAppendWritesHistory

Geschütztes Anfügen schreibt die Verlaufseinstellung für den Blobcontainer mit Rechtsspeichern.

PublicAccess

Gibt an, ob öffentlicher Zugriff auf Daten im Container zulässig ist, und gibt die Zugriffsebene an.

TagProperty

Ein Tag des LegalHold eines Blob-Containers.

UpdateHistoryProperty

Ein Aktualisierungsverlauf der ImmutabilityPolicy eines Blob-Containers.

BlobContainer

Eigenschaften des Blobcontainers, einschließlich ID, Ressourcenname, Ressourcentyp, Etag.

Name Type Description
etag
  • string

Ressourcen-Etag.

id
  • string

Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /abonnements/{subscriptionId}/resourceGroups/{resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Der Name der Ressource

properties.defaultEncryptionScope
  • string

Standardmäßig wird der Container zum Verwenden des angegebenen Verschlüsselungsbereichs für alle Schreibvorgänge verwendet.

properties.deleted
  • boolean

Gibt an, ob der Blobcontainer gelöscht wurde.

properties.deletedTime
  • string

Blob-Containerlöschzeit.

properties.denyEncryptionScopeOverride
  • boolean

Blockieren der Außerkraftsetzung des Verschlüsselungsbereichs aus dem Containerstandard.

properties.enableNfsV3AllSquash
  • boolean

Aktivieren Sie NFSv3 alle Squash im Blob-Container.

properties.enableNfsV3RootSquash
  • boolean

Aktivieren Sie NFSv3-Stamm-Squash im Blobcontainer.

properties.hasImmutabilityPolicy
  • boolean

Die öffentliche Eigenschaft hasImmutabilityPolicy ist auf "true" festgelegt, wenn "ImmutabilityPolicy" für diesen Container erstellt wurde. Die öffentliche Eigenschaft hasImmutabilityPolicy ist auf "false" festgelegt, wenn "ImmutabilityPolicy" für diesen Container nicht erstellt wurde.

properties.hasLegalHold
  • boolean

Die öffentliche HasLegalHold-Eigenschaft wird auf "true" von SRP festgelegt, wenn mindestens ein vorhandenes Tag vorhanden ist. Die öffentliche HasLegalHold-Eigenschaft wird auf "false" von SRP festgelegt, wenn alle vorhandenen gesetzlichen Haltetags gelöscht werden. Für ein bestimmtes Konto kann maximal 1000 Blobcontainer mit hasLegalHold=true vorhanden sein.

properties.immutabilityPolicy

Die ImmutabilityPolicy-Eigenschaft des Containers.

properties.immutableStorageWithVersioning

Die Unveränderlichkeitseigenschaft des Containers auf Objektebene. Die Eigenschaft ist unveränderlich und kann nur zur Containererstellungszeit auf "true" festgelegt werden. Vorhandene Container müssen einem Migrationsprozess unterzogen werden.

properties.lastModifiedTime
  • string

Gibt das Datum und die Uhrzeit der letzten Änderung des Containers zurück.

properties.leaseDuration

Gibt an, ob der Leasingvertrag für einen Container unendlich oder fest ist, nur dann, wenn der Container geleatet wird.

properties.leaseState

Der Leasezustand des Containers.

properties.leaseStatus

Der Leasestatus des Containers.

properties.legalHold

Die LegalHold-Eigenschaft des Containers.

properties.metadata
  • object

Ein Name-Wert-Paar, das dem Container als Metadaten zugeordnet wird.

properties.publicAccess

Gibt an, ob öffentlicher Zugriff auf Daten im Container zulässig ist, und gibt die Zugriffsebene an.

properties.remainingRetentionDays
  • integer

Verbleibende Aufbewahrungstage für einen soft gelöschten Blob-Container.

properties.version
  • string

Die Version des gelöschten Blobcontainers.

type
  • string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft". Storage/storageAccounts"

ImmutabilityPolicyProperties

Die Eigenschaften einer ImmutabilityPolicy eines Blobcontainers.

Name Type Description
etag
  • string

UnveränderlichkeitPolicy Etag.

properties.allowProtectedAppendWrites
  • boolean

Diese Eigenschaft kann nur für entsperrte zeitbasierte Aufbewahrungsrichtlinien geändert werden. Wenn dies aktiviert ist, können neue Blöcke in ein Anfüge-Blob geschrieben werden, während sie den Schutz und die Compliance beibehalten. Es können nur neue Blöcke hinzugefügt werden. Vorhandene Blöcke können nicht geändert oder gelöscht werden. Diese Eigenschaft kann nicht mit der ExtendImmutabilityPolicy-API geändert werden.

properties.allowProtectedAppendWritesAll
  • boolean

Diese Eigenschaft kann nur für entsperrte zeitbasierte Aufbewahrungsrichtlinien geändert werden. Bei aktivierter Aktivierung können neue Blöcke sowohl auf "Append" als auch auf "Bock-Blobs" geschrieben werden, während der Schutz und die Compliance unveränderlich bleiben. Es können nur neue Blöcke hinzugefügt werden. Vorhandene Blöcke können nicht geändert oder gelöscht werden. Diese Eigenschaft kann nicht mit der ExtendImmutabilityPolicy-API geändert werden. Die Eigenschaften "allowProtectedAppendWrites" und "allowProtectedAppendWritesAll" sind gegenseitig exklusiv.

properties.immutabilityPeriodSinceCreationInDays
  • integer

Der Unveränderlichkeitszeitraum für die Blobs im Container seit der Richtlinienerstellung in Tagen.

properties.state

Der Status "UnveränderlichPolicy" eines Blobcontainers, mögliche Werte umfassen: Gesperrt und entsperrt.

updateHistory

Der Verlauf der ImmutabilityPolicy-Aktualisierung des Blobcontainers.

ImmutabilityPolicyState

Der Status "UnveränderlichPolicy" eines Blobcontainers, mögliche Werte umfassen: Gesperrt und entsperrt.

Name Type Description
Locked
  • string
Unlocked
  • string

ImmutabilityPolicyUpdateType

Der Updatetyp "ImmutabilityPolicy" eines Blobcontainers, mögliche Werte umfassen: Put, Lock and Extend.

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

ImmutableStorageWithVersioning

Eigenschaften des Objekts auf Unveränderlichkeit des Containers.

Name Type Description
enabled
  • boolean

Dies ist eine unveränderliche Eigenschaft, wenn sie auf "true" festgelegt ist, ermöglicht die Unveränderbarkeit des Objekts auf Containerebene.

migrationState

Diese Eigenschaft weist die Unveränderbarkeit der Containerebene auf Objektebene auf Unveränderbarkeitsmigrationsstatus zurück.

timeStamp
  • string

Gibt das Datum und die Uhrzeit der Unveränderlichkeit des Objekts zurück.

LeaseDuration

Gibt an, ob der Leasingvertrag für einen Container unendlich oder fest ist, nur dann, wenn der Container geleatet wird.

Name Type Description
Fixed
  • string
Infinite
  • string

LeaseState

Der Leasezustand des Containers.

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

LeaseStatus

Der Leasestatus des Containers.

Name Type Description
Locked
  • string
Unlocked
  • string

LegalHoldProperties

Die LegalHold-Eigenschaft eines Blobcontainers.

Name Type Description
hasLegalHold
  • boolean

Die öffentliche HasLegalHold-Eigenschaft wird auf "true" von SRP festgelegt, wenn mindestens ein vorhandenes Tag vorhanden ist. Die öffentliche HasLegalHold-Eigenschaft wird auf "false" von SRP festgelegt, wenn alle vorhandenen gesetzlichen Haltetags gelöscht werden. Für ein bestimmtes Konto kann maximal 1000 Blobcontainer mit hasLegalHold=true vorhanden sein.

protectedAppendWritesHistory

Der Verlauf des geschützten Anfüge-Blobs wird geschrieben.

tags

Die Liste der LegalHold-Tags eines Blobcontainers.

MigrationState

Diese Eigenschaft weist die Unveränderbarkeit der Containerebene auf Objektebene auf Unveränderbarkeitsmigrationsstatus zurück.

Name Type Description
Completed
  • string
InProgress
  • string

ProtectedAppendWritesHistory

Geschütztes Anfügen schreibt die Verlaufseinstellung für den Blobcontainer mit Rechtsspeichern.

Name Type Description
allowProtectedAppendWritesAll
  • boolean

Bei aktivierter Aktivierung können neue Blöcke sowohl auf "Append" als auch auf "Bock Blobs" geschrieben werden, während sie den Gesetzlichen Schutz und die Compliance beibehalten. Es können nur neue Blöcke hinzugefügt werden. Vorhandene Blöcke können nicht geändert oder gelöscht werden.

timestamp
  • string

Gibt das Datum und die Uhrzeit zurück, zu der das Tag hinzugefügt wurde.

PublicAccess

Gibt an, ob öffentlicher Zugriff auf Daten im Container zulässig ist, und gibt die Zugriffsebene an.

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

TagProperty

Ein Tag des LegalHold eines Blob-Containers.

Name Type Description
objectIdentifier
  • string

Gibt die Objekt-ID des Benutzers zurück, der das Tag hinzugefügt hat.

tag
  • string

Der Tagwert.

tenantId
  • string

Gibt die Mandanten-ID zurück, die das Token für den Benutzer ausgestellt hat, der das Tag hinzugefügt hat.

timestamp
  • string

Gibt das Datum und die Uhrzeit zurück, zu der das Tag hinzugefügt wurde.

upn
  • string

Gibt den Benutzerprinzipalnamen des Benutzers zurück, der das Tag hinzugefügt hat.

UpdateHistoryProperty

Ein Aktualisierungsverlauf der ImmutabilityPolicy eines Blob-Containers.

Name Type Description
allowProtectedAppendWrites
  • boolean

Diese Eigenschaft kann nur für entsperrte zeitbasierte Aufbewahrungsrichtlinien geändert werden. Wenn dies aktiviert ist, können neue Blöcke in ein Anfüge-Blob geschrieben werden, während sie den Schutz und die Compliance beibehalten. Es können nur neue Blöcke hinzugefügt werden. Vorhandene Blöcke können nicht geändert oder gelöscht werden. Diese Eigenschaft kann nicht mit der ExtendImmutabilityPolicy-API geändert werden.

allowProtectedAppendWritesAll
  • boolean

Diese Eigenschaft kann nur für entsperrte zeitbasierte Aufbewahrungsrichtlinien geändert werden. Bei aktivierter Aktivierung können neue Blöcke sowohl auf "Append" als auch auf "Bock-Blobs" geschrieben werden, während der Schutz und die Compliance unveränderlich bleiben. Es können nur neue Blöcke hinzugefügt werden. Vorhandene Blöcke können nicht geändert oder gelöscht werden. Diese Eigenschaft kann nicht mit der ExtendImmutabilityPolicy-API geändert werden. Die Eigenschaften "allowProtectedAppendWrites" und "allowProtectedAppendWritesAll" sind gegenseitig exklusiv.

immutabilityPeriodSinceCreationInDays
  • integer

Der Unveränderlichkeitszeitraum für die Blobs im Container seit der Richtlinienerstellung in Tagen.

objectIdentifier
  • string

Gibt die Objekt-ID des Benutzers zurück, der die ImmutabilityPolicy aktualisiert hat.

tenantId
  • string

Gibt die Mandanten-ID zurück, die das Token für den Benutzer ausgestellt hat, der die ImmutabilityPolicy aktualisiert hat.

timestamp
  • string

Gibt das Datum und die Uhrzeit der Aktualisierung der ImmutabilityPolicy zurück.

update

Der Updatetyp "ImmutabilityPolicy" eines Blobcontainers, mögliche Werte umfassen: Put, Lock and Extend.

upn
  • string

Gibt den Benutzerprinzipalnamen des Benutzers zurück, der die ImmutabilityPolicy aktualisiert hat.