Blob Containers - Update

Riferimento

Service:: Storage Resource Provider

API Version:: 2023-01-01

Aggiornamenti 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=2023-01-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
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. Regex pattern: `^[a-z0-9]+$`
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

Nome	Tipo	Descrizione
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	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	PublicAccess	Specifica se i dati nel contenitore sono accessibili pubblicamente e il livello di accesso.

Risposte

Nome	Tipo	Descrizione
200 OK	BlobContainer	OK - Aggiornare l'operazione contenitore completata correttamente.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Scopes

Nome	Descrizione
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=2023-01-01

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


import com.azure.resourcemanager.storage.fluent.models.BlobContainerInner;
import com.azure.resourcemanager.storage.models.PublicAccess;
import java.util.HashMap;
import java.util.Map;

/** Samples for BlobContainers Update. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/storage/resource-manager/Microsoft.Storage/stable/2023-01-01/examples/BlobContainersPatch.json
     */
    /**
     * Sample code: UpdateContainers.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateContainers(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.storageAccounts().manager().serviceClient().getBlobContainers()
            .updateWithResponse("res3376", "sto328", "container6185", new BlobContainerInner()
                .withPublicAccess(PublicAccess.CONTAINER).withMetadata(mapOf("metadata", "true")),
                com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential
from azure.mgmt.storage import StorageManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-storage
# USAGE
    python blob_containers_patch.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = StorageManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.blob_containers.update(
        resource_group_name="res3376",
        account_name="sto328",
        container_name="container6185",
        blob_container={"properties": {"metadata": {"metadata": "true"}, "publicAccess": "Container"}},
    )
    print(response)


# x-ms-original-file: specification/storage/resource-manager/Microsoft.Storage/stable/2023-01-01/examples/BlobContainersPatch.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armstorage_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/storage/armstorage"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/0baf811c3c76c87b3c127d098519bd97141222dd/specification/storage/resource-manager/Microsoft.Storage/stable/2023-01-01/examples/BlobContainersPatch.json
func ExampleBlobContainersClient_Update() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armstorage.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewBlobContainersClient().Update(ctx, "res3376", "sto328", "container6185", armstorage.BlobContainer{
		ContainerProperties: &armstorage.ContainerProperties{
			Metadata: map[string]*string{
				"metadata": to.Ptr("true"),
			},
			PublicAccess: to.Ptr(armstorage.PublicAccessContainer),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.BlobContainer = armstorage.BlobContainer{
	// 	Name: to.Ptr("container6185"),
	// 	Type: to.Ptr("Microsoft.Storage/storageAccounts/blobServices/containers"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/blobServices/default/containers/container6185"),
	// 	ContainerProperties: &armstorage.ContainerProperties{
	// 		HasImmutabilityPolicy: to.Ptr(false),
	// 		HasLegalHold: to.Ptr(false),
	// 		Metadata: map[string]*string{
	// 			"metadata": to.Ptr("true"),
	// 		},
	// 		PublicAccess: to.Ptr(armstorage.PublicAccessContainer),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { StorageManagementClient } = require("@azure/arm-storage");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Updates container properties as specified in request body. Properties not mentioned in the request will be unchanged. Update fails if the specified container doesn't already exist.
 *
 * @summary Updates container properties as specified in request body. Properties not mentioned in the request will be unchanged. Update fails if the specified container doesn't already exist.
 * x-ms-original-file: specification/storage/resource-manager/Microsoft.Storage/stable/2023-01-01/examples/BlobContainersPatch.json
 */
async function updateContainers() {
  const subscriptionId = process.env["STORAGE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["STORAGE_RESOURCE_GROUP"] || "res3376";
  const accountName = "sto328";
  const containerName = "container6185";
  const blobContainer = {
    metadata: { metadata: "true" },
    publicAccess: "Container",
  };
  const credential = new DefaultAzureCredential();
  const client = new StorageManagementClient(credential, subscriptionId);
  const result = await client.blobContainers.update(
    resourceGroupName,
    accountName,
    containerName,
    blobContainer
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

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

Nome	Descrizione
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 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.

Nome	Tipo	Descrizione
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	ImmutabilityPolicyProperties	Proprietà ImmutabilityPolicy del contenitore.
properties.immutableStorageWithVersioning	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	LeaseDuration	Specifica se il lease in un contenitore è di durata infinita o fissa, solo quando il contenitore viene lease.
properties.leaseState	LeaseState	Stato del lease del contenitore.
properties.leaseStatus	LeaseStatus	Stato del lease del contenitore.
properties.legalHold	LegalHoldProperties	Proprietà LegalHold del contenitore.
properties.metadata	object	Coppia nome-valore da associare al contenitore come metadati.
properties.publicAccess	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.Storage/storageAccounts"

ImmutabilityPolicyProperties

Proprietà di un oggetto ImmutabilityPolicy di un contenitore BLOB.

Nome	Tipo	Descrizione
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	ImmutabilityPolicyState	Lo stato ImmutabilityPolicy di un contenitore BLOB, i valori possibili includono: Bloccato e Sbloccato.
updateHistory	UpdateHistoryProperty[]	Cronologia degli aggiornamenti ImmutabilityPolicy del contenitore BLOB.

ImmutabilityPolicyState

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

Nome	Tipo	Descrizione
Locked	string
Unlocked	string

ImmutabilityPolicyUpdateType

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

Nome	Tipo	Descrizione
extend	string
lock	string
put	string

ImmutableStorageWithVersioning

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

Nome	Tipo	Descrizione
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	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 lease.

Nome	Tipo	Descrizione
Fixed	string
Infinite	string

LeaseState

Stato del lease del contenitore.

Nome	Tipo	Descrizione
Available	string
Breaking	string
Broken	string
Expired	string
Leased	string

LeaseStatus

Stato del lease del contenitore.

Nome	Tipo	Descrizione
Locked	string
Unlocked	string

LegalHoldProperties

Proprietà LegalHold di un contenitore BLOB.

Nome	Tipo	Descrizione
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	ProtectedAppendWritesHistory	Cronologia delle scritture BLOB accodamento protette.
tags	TagProperty[]	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.

Nome	Tipo	Descrizione
Completed	string
InProgress	string

ProtectedAppendWritesHistory

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

Nome	Tipo	Descrizione
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.

Nome	Tipo	Descrizione
Blob	string
Container	string
None	string

TagProperty

Tag di LegalHold di un contenitore BLOB.

Nome	Tipo	Descrizione
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.

Nome	Tipo	Descrizione
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	ImmutabilityPolicyUpdateType	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.

Blob Containers - Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Scopes

Esempio

UpdateContainers

Sample Request

Sample Response

Definizioni

BlobContainer

ImmutabilityPolicyProperties

ImmutabilityPolicyState

ImmutabilityPolicyUpdateType

ImmutableStorageWithVersioning

LeaseDuration

LeaseState

LeaseStatus

LegalHoldProperties

MigrationState

ProtectedAppendWritesHistory

PublicAccess

TagProperty

UpdateHistoryProperty

Risorse aggiuntive