Blob Containers - Update

Referensi

Service:: Storage Resource Provider

API Version:: 2023-01-01

Updates properti kontainer seperti yang ditentukan dalam isi permintaan. Properti yang tidak disebutkan dalam permintaan tidak akan berubah. Pembaruan gagal jika kontainer yang ditentukan belum ada.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
accountName	path	True	string	Nama akun penyimpanan dalam grup sumber daya yang ditentukan. Nama akun penyimpanan harus sepanjang antara 3 dan 24 karakter dan hanya menggunakan angka dan huruf kecil. Regex pattern: `^[a-z0-9]+$`
containerName	path	True	string	Nama kontainer blob dalam akun penyimpanan yang ditentukan. Panjang nama kontainer blob harus antara 3 dan 63 karakter dan menggunakan angka, huruf kecil dan tanda hubung (-) saja. Setiap karakter tanda hubung (-) harus segera didahului dan diikuti dengan huruf atau angka.
resourceGroupName	path	True	string	Nama grup sumber daya dalam langganan pengguna. Nama tidak peka huruf besar/kecil. Regex pattern: `^[-\w\._]+$`
subscriptionId	path	True	string	ID langganan target.
api-version	query	True	string	Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama	Jenis	Deskripsi
properties.defaultEncryptionScope	string	Default kontainer untuk menggunakan cakupan enkripsi tertentu untuk semua penulisan.
properties.denyEncryptionScopeOverride	boolean	Blokir penimpaan cakupan enkripsi dari default kontainer.
properties.enableNfsV3AllSquash	boolean	Aktifkan NFSv3 semua squash pada kontainer blob.
properties.enableNfsV3RootSquash	boolean	Aktifkan NFSv3 root squash pada kontainer blob.
properties.immutableStorageWithVersioning	ImmutableStorageWithVersioning	Properti imutabilitas tingkat objek kontainer. Properti tidak dapat diubah dan hanya dapat diatur ke true pada waktu pembuatan kontainer. Kontainer yang ada harus menjalani proses migrasi.
properties.metadata	object	Pasangan nama-nilai untuk dikaitkan dengan kontainer sebagai metadata.
properties.publicAccess	PublicAccess	Menentukan apakah data dalam kontainer dapat diakses secara publik dan tingkat akses.

Respons

Nama	Jenis	Deskripsi
200 OK	BlobContainer	OK -- Operasi Perbarui Kontainer berhasil diselesaikan.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

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

Scopes

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

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

Definisi

Nama	Deskripsi
BlobContainer	Properti kontainer blob, termasuk Id, nama sumber daya, jenis sumber daya, Etag.
ImmutabilityPolicyProperties	Properti ImmutabilityPolicy dari kontainer blob.
ImmutabilityPolicyState	Status ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: Terkunci dan Tidak Terkunci.
ImmutabilityPolicyUpdateType	Jenis pembaruan ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: put, lock, dan extend.
ImmutableStorageWithVersioning	Properti imutabilitas tingkat objek kontainer.
LeaseDuration	Menentukan apakah sewa pada kontainer memiliki durasi tak terbatas atau tetap, hanya ketika kontainer disewakan.
LeaseState	Status sewa kontainer.
LeaseStatus	Status sewa kontainer.
LegalHoldProperties	Properti LegalHold dari kontainer blob.
MigrationState	Properti ini menunjukkan tingkat kekekalan kontainer terhadap status migrasi kekekalan tingkat objek.
ProtectedAppendWritesHistory	Penampan terlindungi menulis pengaturan riwayat untuk kontainer blob dengan Penahanan legal.
PublicAccess	Menentukan apakah data dalam kontainer dapat diakses secara publik dan tingkat akses.
TagProperty	Tag LegalHold dari kontainer blob.
UpdateHistoryProperty	Riwayat pembaruan ImmutabilityPolicy dari kontainer blob.

BlobContainer

Properti kontainer blob, termasuk Id, nama sumber daya, jenis sumber daya, Etag.

Nama	Jenis	Deskripsi
etag	string	Sumber Daya Etag.
id	string	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nama sumber daya.
properties.defaultEncryptionScope	string	Default kontainer untuk menggunakan cakupan enkripsi tertentu untuk semua penulisan.
properties.deleted	boolean	Menunjukkan apakah kontainer blob dihapus.
properties.deletedTime	string	Waktu penghapusan kontainer blob.
properties.denyEncryptionScopeOverride	boolean	Blokir penimpaan cakupan enkripsi dari default kontainer.
properties.enableNfsV3AllSquash	boolean	Aktifkan NFSv3 semua squash pada kontainer blob.
properties.enableNfsV3RootSquash	boolean	Aktifkan NFSv3 root squash pada kontainer blob.
properties.hasImmutabilityPolicy	boolean	Properti publik hasImmutabilityPolicy diatur ke true oleh SRP jika ImmutabilityPolicy telah dibuat untuk kontainer ini. Properti publik hasImmutabilityPolicy diatur ke false oleh SRP jika ImmutabilityPolicy belum dibuat untuk kontainer ini.
properties.hasLegalHold	boolean	Properti publik hasLegalHold diatur ke true oleh SRP jika setidaknya ada satu tag yang ada. Properti publik hasLegalHold diatur ke false oleh SRP jika semua tag penahanan legal yang ada dibersihkan. Mungkin ada maksimal 1000 kontainer blob dengan hasLegalHold=true untuk akun tertentu.
properties.immutabilityPolicy	ImmutabilityPolicyProperties	Properti ImmutabilityPolicy dari kontainer.
properties.immutableStorageWithVersioning	ImmutableStorageWithVersioning	Properti imutabilitas tingkat objek kontainer. Properti tidak dapat diubah dan hanya dapat diatur ke true pada waktu pembuatan kontainer. Kontainer yang ada harus menjalani proses migrasi.
properties.lastModifiedTime	string	Mengembalikan tanggal dan waktu kontainer terakhir diubah.
properties.leaseDuration	LeaseDuration	Menentukan apakah sewa pada kontainer memiliki durasi tak terbatas atau tetap, hanya ketika kontainer disewakan.
properties.leaseState	LeaseState	Status sewa kontainer.
properties.leaseStatus	LeaseStatus	Status sewa kontainer.
properties.legalHold	LegalHoldProperties	Properti LegalHold dari kontainer.
properties.metadata	object	Pasangan nama-nilai untuk dikaitkan dengan kontainer sebagai metadata.
properties.publicAccess	PublicAccess	Menentukan apakah data dalam kontainer dapat diakses secara publik dan tingkat akses.
properties.remainingRetentionDays	integer	Sisa hari retensi untuk kontainer blob yang dihapus sementara.
properties.version	string	Versi kontainer blob yang dihapus.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

ImmutabilityPolicyProperties

Properti ImmutabilityPolicy dari kontainer blob.

Nama	Jenis	Deskripsi
etag	string	ImmutabilityPolicy Etag.
properties.allowProtectedAppendWrites	boolean	Properti ini hanya dapat diubah untuk kebijakan penyimpanan berbasis waktu yang tidak terkunci. Saat diaktifkan, blok baru dapat ditulis ke blob penambahan sambil mempertahankan perlindungan dan kepatuhan imutabilitas. Hanya blok baru yang dapat ditambahkan dan blok yang ada tidak dapat dimodifikasi atau dihapus. Properti ini tidak dapat diubah dengan ExtendImmutabilityPolicy API.
properties.allowProtectedAppendWritesAll	boolean	Properti ini hanya dapat diubah untuk kebijakan penyimpanan berbasis waktu yang tidak terkunci. Saat diaktifkan, blok baru dapat ditulis ke 'Tambahkan dan Bock Blob' sambil mempertahankan perlindungan dan kepatuhan imutabilitas. Hanya blok baru yang dapat ditambahkan dan blok yang ada tidak dapat dimodifikasi atau dihapus. Properti ini tidak dapat diubah dengan ExtendImmutabilityPolicy API. Properti 'allowProtectedAppendWrites' dan 'allowProtectedAppendWritesAll' saling eksklusif.
properties.immutabilityPeriodSinceCreationInDays	integer	Periode imutabilitas untuk blob dalam kontainer sejak pembuatan kebijakan, dalam beberapa hari.
properties.state	ImmutabilityPolicyState	Status ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: Terkunci dan Tidak Terkunci.
updateHistory	UpdateHistoryProperty[]	Riwayat pembaruan ImmutabilityPolicy dari kontainer blob.

ImmutabilityPolicyState

Status ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: Terkunci dan Tidak Terkunci.

Nama	Jenis	Deskripsi
Locked	string
Unlocked	string

ImmutabilityPolicyUpdateType

Jenis pembaruan ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: put, lock, dan extend.

Nama	Jenis	Deskripsi
extend	string
lock	string
put	string

ImmutableStorageWithVersioning

Properti imutabilitas tingkat objek kontainer.

Nama	Jenis	Deskripsi
enabled	boolean	Ini adalah properti yang tidak dapat diubah, ketika diatur ke true, ini memungkinkan kekekalan tingkat objek pada tingkat kontainer.
migrationState	MigrationState	Properti ini menunjukkan tingkat kekekalan kontainer terhadap status migrasi kekekalan tingkat objek.
timeStamp	string	Mengembalikan tanggal dan waktu kekekalan tingkat objek diaktifkan.

LeaseDuration

Menentukan apakah sewa pada kontainer memiliki durasi tak terbatas atau tetap, hanya ketika kontainer disewakan.

Nama	Jenis	Deskripsi
Fixed	string
Infinite	string

LeaseState

Status sewa kontainer.

Nama	Jenis	Deskripsi
Available	string
Breaking	string
Broken	string
Expired	string
Leased	string

LeaseStatus

Status sewa kontainer.

Nama	Jenis	Deskripsi
Locked	string
Unlocked	string

LegalHoldProperties

Properti LegalHold dari kontainer blob.

Nama	Jenis	Deskripsi
hasLegalHold	boolean	Properti publik hasLegalHold diatur ke true oleh SRP jika setidaknya ada satu tag yang ada. Properti publik hasLegalHold diatur ke false oleh SRP jika semua tag penahanan legal yang ada dibersihkan. Mungkin ada maksimal 1000 kontainer blob dengan hasLegalHold=true untuk akun tertentu.
protectedAppendWritesHistory	ProtectedAppendWritesHistory	Menambahkan riwayat penulisan blob yang dilindungi.
tags	TagProperty[]	Daftar tag LegalHold dari kontainer blob.

MigrationState

Properti ini menunjukkan tingkat kekekalan kontainer terhadap status migrasi kekekalan tingkat objek.

Nama	Jenis	Deskripsi
Completed	string
InProgress	string

ProtectedAppendWritesHistory

Penampan terlindungi menulis pengaturan riwayat untuk kontainer blob dengan Penahanan legal.

Nama	Jenis	Deskripsi
allowProtectedAppendWritesAll	boolean	Saat diaktifkan, blok baru dapat ditulis ke 'Tambahkan dan Bock Blob' sambil mempertahankan perlindungan dan kepatuhan penahanan hukum. Hanya blok baru yang dapat ditambahkan dan blok yang ada tidak dapat dimodifikasi atau dihapus.
timestamp	string	Mengembalikan tanggal dan waktu tag ditambahkan.

PublicAccess

Menentukan apakah data dalam kontainer dapat diakses secara publik dan tingkat akses.

Nama	Jenis	Deskripsi
Blob	string
Container	string
None	string

TagProperty

Tag LegalHold dari kontainer blob.

Nama	Jenis	Deskripsi
objectIdentifier	string	Mengembalikan ID Objek pengguna yang menambahkan tag.
tag	string	Nilai tag.
tenantId	string	Mengembalikan ID Penyewa yang mengeluarkan token untuk pengguna yang menambahkan tag.
timestamp	string	Mengembalikan tanggal dan waktu tag ditambahkan.
upn	string	Mengembalikan Nama Prinsipal Pengguna pengguna yang menambahkan tag.

UpdateHistoryProperty

Riwayat pembaruan ImmutabilityPolicy dari kontainer blob.

Nama	Jenis	Deskripsi
allowProtectedAppendWrites	boolean	Properti ini hanya dapat diubah untuk kebijakan penyimpanan berbasis waktu yang tidak terkunci. Saat diaktifkan, blok baru dapat ditulis ke blob penambahan sambil mempertahankan perlindungan dan kepatuhan imutabilitas. Hanya blok baru yang dapat ditambahkan dan blok yang ada tidak dapat dimodifikasi atau dihapus. Properti ini tidak dapat diubah dengan ExtendImmutabilityPolicy API.
allowProtectedAppendWritesAll	boolean	Properti ini hanya dapat diubah untuk kebijakan penyimpanan berbasis waktu yang tidak terkunci. Saat diaktifkan, blok baru dapat ditulis ke 'Tambahkan dan Bock Blob' sambil mempertahankan perlindungan dan kepatuhan imutabilitas. Hanya blok baru yang dapat ditambahkan dan blok yang ada tidak dapat dimodifikasi atau dihapus. Properti ini tidak dapat diubah dengan ExtendImmutabilityPolicy API. Properti 'allowProtectedAppendWrites' dan 'allowProtectedAppendWritesAll' saling eksklusif.
immutabilityPeriodSinceCreationInDays	integer	Periode imutabilitas untuk blob dalam kontainer sejak pembuatan kebijakan, dalam beberapa hari.
objectIdentifier	string	Mengembalikan ID Objek pengguna yang memperbarui ImmutabilityPolicy.
tenantId	string	Mengembalikan ID Penyewa yang mengeluarkan token untuk pengguna yang memperbarui ImmutabilityPolicy.
timestamp	string	Mengembalikan tanggal dan waktu ImmutabilityPolicy diperbarui.
update	ImmutabilityPolicyUpdateType	Jenis pembaruan ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: put, lock, dan extend.
upn	string	Mengembalikan Nama Prinsipal Pengguna pengguna yang memperbarui ImmutabilityPolicy.

Blob Containers - Update

Parameter URI

Isi Permintaan

Respons

Keamanan

azure_auth

Scopes

Contoh

UpdateContainers

Sample Request

Sample Response

Definisi

BlobContainer

ImmutabilityPolicyProperties

ImmutabilityPolicyState

ImmutabilityPolicyUpdateType

ImmutableStorageWithVersioning

LeaseDuration

LeaseState

LeaseStatus

LegalHoldProperties

MigrationState

ProtectedAppendWritesHistory

PublicAccess

TagProperty

UpdateHistoryProperty

Sumber Daya Tambahan: