Blob Containers - Get

Hizmet:

Storage Resource Provider

API Sürümü:

2024-01-01

Belirtilen kapsayıcının özelliklerini alır.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Belirtilen kaynak grubu içindeki depolama hesabının adı. Depolama hesabı adlarının uzunluğu 3 ile 24 karakter arasında olmalı ve yalnızca sayıları ve küçük harfleri kullanmalıdır.
containerName	path	True	string minLength: 3 maxLength: 63	Belirtilen depolama hesabı içindeki blob kapsayıcısının adı. Blob kapsayıcı adlarının uzunluğu 3 ile 63 karakter arasında olmalı ve yalnızca küçük harf ve tire (-) olmak üzere sayıları kullanmalıdır. Her tire (-) karakterinin hemen önüne ve ardından bir harf veya sayı eklenmelidir.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._\(\)]+$	Kullanıcının aboneliğindeki kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
subscriptionId	path	True	string minLength: 1	Hedef aboneliğin kimliği.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	BlobContainer	Tamam -- Kapsayıcı alma işlemi başarıyla tamamlandı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

GetBlobContainersGetWithAllowProtectedAppendWritesAll

GetContainers

GetBlobContainersGetWithAllowProtectedAppendWritesAll

Örnek isteği

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/blobServices/default/containers/container1634?api-version=2024-01-01

Java

/**
 * Samples for BlobContainers Get.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/storage/resource-manager/Microsoft.Storage/stable/2024-01-01/examples/
     * BlobContainersGetWithAllowProtectedAppendWritesAll.json
     */
    /**
     * Sample code: GetBlobContainersGetWithAllowProtectedAppendWritesAll.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getBlobContainersGetWithAllowProtectedAppendWritesAll(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.storageAccounts().manager().serviceClient().getBlobContainers().getWithResponse("res9871", "sto6217",
            "container1634", com.azure.core.util.Context.NONE);
    }
}

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

Python

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_get_with_allow_protected_append_writes_all.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.get(
        resource_group_name="res9871",
        account_name="sto6217",
        container_name="container1634",
    )
    print(response)


# x-ms-original-file: specification/storage/resource-manager/Microsoft.Storage/stable/2024-01-01/examples/BlobContainersGetWithAllowProtectedAppendWritesAll.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

Go

package armstorage_test

import (
	"context"
	"log"

	"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/86c6306649b02e542117adb46c61e8019dbd78e9/specification/storage/resource-manager/Microsoft.Storage/stable/2024-01-01/examples/BlobContainersGetWithAllowProtectedAppendWritesAll.json
func ExampleBlobContainersClient_Get_getBlobContainersGetWithAllowProtectedAppendWritesAll() {
	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().Get(ctx, "res9871", "sto6217", "container1634", 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("container1634"),
	// 	Type: to.Ptr("Microsoft.Storage/storageAccounts/blobServices/containers"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/blobServices/default/containers/container1634"),
	// 	Etag: to.Ptr("\"0x8D592D74CC20EBA\""),
	// 	ContainerProperties: &armstorage.ContainerProperties{
	// 		HasImmutabilityPolicy: to.Ptr(true),
	// 		HasLegalHold: to.Ptr(true),
	// 		ImmutabilityPolicy: &armstorage.ImmutabilityPolicyProperties{
	// 			Etag: to.Ptr("\"8d592d74cb3011a\""),
	// 			Properties: &armstorage.ImmutabilityPolicyProperty{
	// 				AllowProtectedAppendWritesAll: to.Ptr(true),
	// 				ImmutabilityPeriodSinceCreationInDays: to.Ptr[int32](100),
	// 				State: to.Ptr(armstorage.ImmutabilityPolicyStateLocked),
	// 			},
	// 			UpdateHistory: []*armstorage.UpdateHistoryProperty{
	// 				{
	// 					AllowProtectedAppendWritesAll: to.Ptr(true),
	// 					ImmutabilityPeriodSinceCreationInDays: to.Ptr[int32](3),
	// 					ObjectIdentifier: to.Ptr("ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b"),
	// 					TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-26T05:06:11.431Z"); return t}()),
	// 					Update: to.Ptr(armstorage.ImmutabilityPolicyUpdateTypePut),
	// 				},
	// 				{
	// 					AllowProtectedAppendWritesAll: to.Ptr(true),
	// 					ImmutabilityPeriodSinceCreationInDays: to.Ptr[int32](3),
	// 					ObjectIdentifier: to.Ptr("ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b"),
	// 					TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-26T05:06:13.090Z"); return t}()),
	// 					Update: to.Ptr(armstorage.ImmutabilityPolicyUpdateTypeLock),
	// 				},
	// 				{
	// 					AllowProtectedAppendWritesAll: to.Ptr(true),
	// 					ImmutabilityPeriodSinceCreationInDays: to.Ptr[int32](100),
	// 					ObjectIdentifier: to.Ptr("ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b"),
	// 					TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-26T05:06:14.709Z"); return t}()),
	// 					Update: to.Ptr(armstorage.ImmutabilityPolicyUpdateTypeExtend),
	// 			}},
	// 		},
	// 		LastModifiedTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-26T05:06:14.000Z"); return t}()),
	// 		LeaseState: to.Ptr(armstorage.LeaseStateAvailable),
	// 		LeaseStatus: to.Ptr(armstorage.LeaseStatusUnlocked),
	// 		LegalHold: &armstorage.LegalHoldProperties{
	// 			HasLegalHold: to.Ptr(true),
	// 			ProtectedAppendWritesHistory: &armstorage.ProtectedAppendWritesHistory{
	// 				AllowProtectedAppendWritesAll: to.Ptr(true),
	// 				Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-09-01T01:58:44.504Z"); return t}()),
	// 			},
	// 			Tags: []*armstorage.TagProperty{
	// 				{
	// 					ObjectIdentifier: to.Ptr("ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b"),
	// 					Tag: to.Ptr("tag1"),
	// 					TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-26T05:06:09.696Z"); return t}()),
	// 				},
	// 				{
	// 					ObjectIdentifier: to.Ptr("ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b"),
	// 					Tag: to.Ptr("tag2"),
	// 					TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-26T05:06:09.696Z"); return t}()),
	// 				},
	// 				{
	// 					ObjectIdentifier: to.Ptr("ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b"),
	// 					Tag: to.Ptr("tag3"),
	// 					TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-26T05:06:09.696Z"); return t}()),
	// 			}},
	// 		},
	// 		PublicAccess: to.Ptr(armstorage.PublicAccessNone),
	// 	},
	// }
}

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

JavaScript

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

/**
 * This sample demonstrates how to Gets properties of a specified container.
 *
 * @summary Gets properties of a specified container.
 * x-ms-original-file: specification/storage/resource-manager/Microsoft.Storage/stable/2024-01-01/examples/BlobContainersGetWithAllowProtectedAppendWritesAll.json
 */
async function getBlobContainersGetWithAllowProtectedAppendWritesAll() {
  const subscriptionId = process.env["STORAGE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["STORAGE_RESOURCE_GROUP"] || "res9871";
  const accountName = "sto6217";
  const containerName = "container1634";
  const credential = new DefaultAzureCredential();
  const client = new StorageManagementClient(credential, subscriptionId);
  const result = await client.blobContainers.get(resourceGroupName, accountName, containerName);
  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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Storage.Models;
using Azure.ResourceManager.Storage;

// Generated from example definition: specification/storage/resource-manager/Microsoft.Storage/stable/2024-01-01/examples/BlobContainersGetWithAllowProtectedAppendWritesAll.json
// this example is just showing the usage of "BlobContainers_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this BlobServiceResource created on azure
// for more information of creating BlobServiceResource, please refer to the document of BlobServiceResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "res9871";
string accountName = "sto6217";
ResourceIdentifier blobServiceResourceId = BlobServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName);
BlobServiceResource blobService = client.GetBlobServiceResource(blobServiceResourceId);

// get the collection of this BlobContainerResource
BlobContainerCollection collection = blobService.GetBlobContainers();

// invoke the operation
string containerName = "container1634";
NullableResponse<BlobContainerResource> response = await collection.GetIfExistsAsync(containerName);
BlobContainerResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine("Succeeded with null as result");
}
else
{
    // the variable result is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    BlobContainerData resourceData = result.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

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

Örnek yanıt

Durum kodu:

200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/blobServices/default/containers/container1634",
  "name": "container1634",
  "type": "Microsoft.Storage/storageAccounts/blobServices/containers",
  "etag": "\"0x8D592D74CC20EBA\"",
  "properties": {
    "publicAccess": "None",
    "leaseStatus": "Unlocked",
    "leaseState": "Available",
    "lastModifiedTime": "2018-03-26T05:06:14Z",
    "immutabilityPolicy": {
      "etag": "\"8d592d74cb3011a\"",
      "properties": {
        "immutabilityPeriodSinceCreationInDays": 100,
        "allowProtectedAppendWritesAll": true,
        "state": "Locked"
      },
      "updateHistory": [
        {
          "update": "put",
          "immutabilityPeriodSinceCreationInDays": 3,
          "allowProtectedAppendWritesAll": true,
          "timestamp": "2018-03-26T05:06:11.431403Z",
          "objectIdentifier": "ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b",
          "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
        },
        {
          "update": "lock",
          "immutabilityPeriodSinceCreationInDays": 3,
          "allowProtectedAppendWritesAll": true,
          "timestamp": "2018-03-26T05:06:13.0907641Z",
          "objectIdentifier": "ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b",
          "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
        },
        {
          "update": "extend",
          "immutabilityPeriodSinceCreationInDays": 100,
          "allowProtectedAppendWritesAll": true,
          "timestamp": "2018-03-26T05:06:14.7097716Z",
          "objectIdentifier": "ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b",
          "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
        }
      ]
    },
    "legalHold": {
      "hasLegalHold": true,
      "protectedAppendWritesHistory": {
        "allowProtectedAppendWritesAll": true,
        "timestamp": "2022-09-01T01:58:44.5044483Z"
      },
      "tags": [
        {
          "tag": "tag1",
          "timestamp": "2018-03-26T05:06:09.6964643Z",
          "objectIdentifier": "ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b",
          "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
        },
        {
          "tag": "tag2",
          "timestamp": "2018-03-26T05:06:09.6964643Z",
          "objectIdentifier": "ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b",
          "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
        },
        {
          "tag": "tag3",
          "timestamp": "2018-03-26T05:06:09.6964643Z",
          "objectIdentifier": "ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b",
          "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
        }
      ]
    },
    "hasImmutabilityPolicy": true,
    "hasLegalHold": true
  }
}

GetContainers

Örnek isteği

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/blobServices/default/containers/container1634?api-version=2024-01-01

Java

/**
 * Samples for BlobContainers Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/storage/resource-manager/Microsoft.Storage/stable/2024-01-01/examples/BlobContainersGet.json
     */
    /**
     * Sample code: GetContainers.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getContainers(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.storageAccounts().manager().serviceClient().getBlobContainers().getWithResponse("res9871", "sto6217",
            "container1634", com.azure.core.util.Context.NONE);
    }
}

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

Python

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_get.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.get(
        resource_group_name="res9871",
        account_name="sto6217",
        container_name="container1634",
    )
    print(response)


# x-ms-original-file: specification/storage/resource-manager/Microsoft.Storage/stable/2024-01-01/examples/BlobContainersGet.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

Go

package armstorage_test

import (
	"context"
	"log"

	"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/86c6306649b02e542117adb46c61e8019dbd78e9/specification/storage/resource-manager/Microsoft.Storage/stable/2024-01-01/examples/BlobContainersGet.json
func ExampleBlobContainersClient_Get_getContainers() {
	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().Get(ctx, "res9871", "sto6217", "container1634", 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("container1634"),
	// 	Type: to.Ptr("Microsoft.Storage/storageAccounts/blobServices/containers"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/blobServices/default/containers/container1634"),
	// 	Etag: to.Ptr("\"0x8D592D74CC20EBA\""),
	// 	ContainerProperties: &armstorage.ContainerProperties{
	// 		HasImmutabilityPolicy: to.Ptr(true),
	// 		HasLegalHold: to.Ptr(true),
	// 		ImmutabilityPolicy: &armstorage.ImmutabilityPolicyProperties{
	// 			Etag: to.Ptr("\"8d592d74cb3011a\""),
	// 			Properties: &armstorage.ImmutabilityPolicyProperty{
	// 				ImmutabilityPeriodSinceCreationInDays: to.Ptr[int32](100),
	// 				State: to.Ptr(armstorage.ImmutabilityPolicyStateLocked),
	// 			},
	// 			UpdateHistory: []*armstorage.UpdateHistoryProperty{
	// 				{
	// 					ImmutabilityPeriodSinceCreationInDays: to.Ptr[int32](3),
	// 					ObjectIdentifier: to.Ptr("ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b"),
	// 					TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-26T05:06:11.431Z"); return t}()),
	// 					Update: to.Ptr(armstorage.ImmutabilityPolicyUpdateTypePut),
	// 				},
	// 				{
	// 					ImmutabilityPeriodSinceCreationInDays: to.Ptr[int32](3),
	// 					ObjectIdentifier: to.Ptr("ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b"),
	// 					TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-26T05:06:13.090Z"); return t}()),
	// 					Update: to.Ptr(armstorage.ImmutabilityPolicyUpdateTypeLock),
	// 				},
	// 				{
	// 					ImmutabilityPeriodSinceCreationInDays: to.Ptr[int32](100),
	// 					ObjectIdentifier: to.Ptr("ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b"),
	// 					TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-26T05:06:14.709Z"); return t}()),
	// 					Update: to.Ptr(armstorage.ImmutabilityPolicyUpdateTypeExtend),
	// 			}},
	// 		},
	// 		LastModifiedTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-26T05:06:14.000Z"); return t}()),
	// 		LeaseState: to.Ptr(armstorage.LeaseStateAvailable),
	// 		LeaseStatus: to.Ptr(armstorage.LeaseStatusUnlocked),
	// 		LegalHold: &armstorage.LegalHoldProperties{
	// 			HasLegalHold: to.Ptr(true),
	// 			Tags: []*armstorage.TagProperty{
	// 				{
	// 					ObjectIdentifier: to.Ptr("ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b"),
	// 					Tag: to.Ptr("tag1"),
	// 					TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-26T05:06:09.696Z"); return t}()),
	// 				},
	// 				{
	// 					ObjectIdentifier: to.Ptr("ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b"),
	// 					Tag: to.Ptr("tag2"),
	// 					TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-26T05:06:09.696Z"); return t}()),
	// 				},
	// 				{
	// 					ObjectIdentifier: to.Ptr("ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b"),
	// 					Tag: to.Ptr("tag3"),
	// 					TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-26T05:06:09.696Z"); return t}()),
	// 			}},
	// 		},
	// 		PublicAccess: to.Ptr(armstorage.PublicAccessNone),
	// 	},
	// }
}

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

JavaScript

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

/**
 * This sample demonstrates how to Gets properties of a specified container.
 *
 * @summary Gets properties of a specified container.
 * x-ms-original-file: specification/storage/resource-manager/Microsoft.Storage/stable/2024-01-01/examples/BlobContainersGet.json
 */
async function getContainers() {
  const subscriptionId = process.env["STORAGE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["STORAGE_RESOURCE_GROUP"] || "res9871";
  const accountName = "sto6217";
  const containerName = "container1634";
  const credential = new DefaultAzureCredential();
  const client = new StorageManagementClient(credential, subscriptionId);
  const result = await client.blobContainers.get(resourceGroupName, accountName, containerName);
  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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Storage.Models;
using Azure.ResourceManager.Storage;

// Generated from example definition: specification/storage/resource-manager/Microsoft.Storage/stable/2024-01-01/examples/BlobContainersGet.json
// this example is just showing the usage of "BlobContainers_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this BlobServiceResource created on azure
// for more information of creating BlobServiceResource, please refer to the document of BlobServiceResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "res9871";
string accountName = "sto6217";
ResourceIdentifier blobServiceResourceId = BlobServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName);
BlobServiceResource blobService = client.GetBlobServiceResource(blobServiceResourceId);

// get the collection of this BlobContainerResource
BlobContainerCollection collection = blobService.GetBlobContainers();

// invoke the operation
string containerName = "container1634";
NullableResponse<BlobContainerResource> response = await collection.GetIfExistsAsync(containerName);
BlobContainerResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine("Succeeded with null as result");
}
else
{
    // the variable result is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    BlobContainerData resourceData = result.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

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

Örnek yanıt

Durum kodu:

200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/blobServices/default/containers/container1634",
  "name": "container1634",
  "type": "Microsoft.Storage/storageAccounts/blobServices/containers",
  "etag": "\"0x8D592D74CC20EBA\"",
  "properties": {
    "publicAccess": "None",
    "leaseStatus": "Unlocked",
    "leaseState": "Available",
    "lastModifiedTime": "2018-03-26T05:06:14Z",
    "immutabilityPolicy": {
      "etag": "\"8d592d74cb3011a\"",
      "properties": {
        "immutabilityPeriodSinceCreationInDays": 100,
        "state": "Locked"
      },
      "updateHistory": [
        {
          "update": "put",
          "immutabilityPeriodSinceCreationInDays": 3,
          "timestamp": "2018-03-26T05:06:11.431403Z",
          "objectIdentifier": "ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b",
          "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
        },
        {
          "update": "lock",
          "immutabilityPeriodSinceCreationInDays": 3,
          "timestamp": "2018-03-26T05:06:13.0907641Z",
          "objectIdentifier": "ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b",
          "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
        },
        {
          "update": "extend",
          "immutabilityPeriodSinceCreationInDays": 100,
          "timestamp": "2018-03-26T05:06:14.7097716Z",
          "objectIdentifier": "ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b",
          "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
        }
      ]
    },
    "legalHold": {
      "hasLegalHold": true,
      "tags": [
        {
          "tag": "tag1",
          "timestamp": "2018-03-26T05:06:09.6964643Z",
          "objectIdentifier": "ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b",
          "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
        },
        {
          "tag": "tag2",
          "timestamp": "2018-03-26T05:06:09.6964643Z",
          "objectIdentifier": "ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b",
          "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
        },
        {
          "tag": "tag3",
          "timestamp": "2018-03-26T05:06:09.6964643Z",
          "objectIdentifier": "ce7cd28a-fc25-4bf1-8fb9-e1b9833ffd4b",
          "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
        }
      ]
    },
    "hasImmutabilityPolicy": true,
    "hasLegalHold": true
  }
}

Tanımlar

Name	Description
BlobContainer	Kimlik, kaynak adı, kaynak türü, Etag gibi blob kapsayıcısının özellikleri.
ImmutabilityPolicyProperties	Blob kapsayıcısının ImmutabilityPolicy özellikleri.
ImmutabilityPolicyState	Blob kapsayıcısının ImmutabilityPolicy durumu, olası değerler şunlardır: Kilitli ve Kilidi Açıldı.
ImmutabilityPolicyUpdateType	Blob kapsayıcısının ImmutabilityPolicy güncelleştirme türü, olası değerler şunlardır: put, lock ve extend.
ImmutableStorageWithVersioning	Kapsayıcının nesne düzeyinde değişmezlik özellikleri.
LeaseDuration	Bir kapsayıcıdaki kiralamanın sonsuz mu yoksa sabit bir süre mi olduğunu, yalnızca kapsayıcı kiralandığında belirtir.
LeaseState	Kapsayıcının kira durumu.
LeaseStatus	Kapsayıcının kira durumu.
LegalHoldProperties	Blob kapsayıcısının LegalHold özelliği.
MigrationState	Bu özellik, kapsayıcı düzeyinde nesne düzeyinde değişmezlik geçiş durumunu belirtir.
ProtectedAppendWritesHistory	Yasal tutmalar içeren blob kapsayıcısı için korumalı ekleme yazma geçmişi ayarı.
PublicAccess	Kapsayıcıdaki verilere genel olarak erişilip erişilemeyeceğini ve erişim düzeyini belirtir.
TagProperty	Blob kapsayıcısının LegalHold etiketi.
UpdateHistoryProperty	Blob kapsayıcısının ImmutabilityPolicy güncelleştirme geçmişi.

BlobContainer

Object

Kimlik, kaynak adı, kaynak türü, Etag gibi blob kapsayıcısının özellikleri.

Name	Tür	Description
etag	string	Kaynak Etag'i.
id	string	Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Kaynağın adı
properties.defaultEncryptionScope	string	Kapsayıcıyı varsayılan olarak tüm yazma işlemleri için belirtilen şifreleme kapsamını kullanacak şekilde ayarlayın.
properties.deleted	boolean	Blob kapsayıcısının silinip silinmediğini gösterir.
properties.deletedTime	string (date-time)	Blob kapsayıcı silme süresi.
properties.denyEncryptionScopeOverride	boolean	Kapsayıcı varsayılanından şifreleme kapsamını geçersiz kılmayı engelleyin.
properties.enableNfsV3AllSquash	boolean	NFSv3 blob kapsayıcısı üzerindeki tüm squash'ları etkinleştirin.
properties.enableNfsV3RootSquash	boolean	Blob kapsayıcısı üzerinde NFSv3 kök sıkıştırmasını etkinleştirin.
properties.hasImmutabilityPolicy	boolean	Bu kapsayıcı için ImmutabilityPolicy oluşturulduysa hasImmutabilityPolicy ortak özelliği SRP tarafından true olarak ayarlanır. Bu kapsayıcı için ImmutabilityPolicy oluşturulmadıysa hasImmutabilityPolicy ortak özelliği SRP tarafından false olarak ayarlanır.
properties.hasLegalHold	boolean	HasLegalHold ortak özelliği, en az bir mevcut etiket varsa SRP tarafından true olarak ayarlanır. Mevcut tüm yasal tutma etiketleri temizlenirse hasLegalHold ortak özelliği SRP tarafından false olarak ayarlanır. Belirli bir hesap için hasLegalHold=true olan en fazla 1000 blob kapsayıcısı olabilir.
properties.immutabilityPolicy	ImmutabilityPolicyProperties	Kapsayıcının ImmutabilityPolicy özelliği.
properties.immutableStorageWithVersioning	ImmutableStorageWithVersioning	Kapsayıcının nesne düzeyinde değişmezlik özelliği. Özelliği sabittir ve yalnızca kapsayıcı oluşturma zamanında true olarak ayarlanabilir. Mevcut kapsayıcılar bir geçiş işlemine tabi tutulmalıdır.
properties.lastModifiedTime	string (date-time)	Kapsayıcının en son değiştirildiği tarih ve saati döndürür.
properties.leaseDuration	LeaseDuration	Bir kapsayıcıdaki kiralamanın sonsuz mu yoksa sabit bir süre mi olduğunu, yalnızca kapsayıcı kiralandığında belirtir.
properties.leaseState	LeaseState	Kapsayıcının kira durumu.
properties.leaseStatus	LeaseStatus	Kapsayıcının kira durumu.
properties.legalHold	LegalHoldProperties	Kapsayıcının LegalHold özelliği.
properties.metadata	object	Kapsayıcıyla meta veri olarak ilişkilendirilecek bir ad-değer çifti.
properties.publicAccess	PublicAccess	Kapsayıcıdaki verilere genel olarak erişilip erişilemeyeceğini ve erişim düzeyini belirtir.
properties.remainingRetentionDays	integer	Geçici olarak silinen blob kapsayıcısı için kalan saklama günleri.
properties.version	string	Silinen blob kapsayıcısının sürümü.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

ImmutabilityPolicyProperties

Object

Blob kapsayıcısının ImmutabilityPolicy özellikleri.

Name	Tür	Description
etag	string	ImmutabilityPolicy Etag.
properties.allowProtectedAppendWrites	boolean	Bu özellik yalnızca kilidi açılmış zamana bağlı saklama ilkeleri için değiştirilebilir. Etkinleştirildiğinde, değişmezlik koruması ve uyumluluğu korunurken ekleme blobuna yeni bloklar yazılabilir. Yalnızca yeni bloklar eklenebilir ve mevcut bloklar değiştirilemez veya silinemez. Bu özellik ExtendImmutabilityPolicy API'siyle değiştirilemez.
properties.allowProtectedAppendWritesAll	boolean	Bu özellik yalnızca kilidi açılmış zamana bağlı saklama ilkeleri için değiştirilebilir. Etkinleştirildiğinde, değişmezlik koruması ve uyumluluğu korunurken yeni bloklar hem 'Ekleme hem de Bock Bloblarına' yazılabilir. Yalnızca yeni bloklar eklenebilir ve mevcut bloklar değiştirilemez veya silinemez. Bu özellik ExtendImmutabilityPolicy API'siyle değiştirilemez. 'allowProtectedAppendWrites' ve 'allowProtectedAppendWritesAll' özellikleri birbirini dışlar.
properties.immutabilityPeriodSinceCreationInDays	integer	İlke oluşturma işleminden bu yana kapsayıcıdaki bloblar için gün cinsinden değişmezlik süresi.
properties.state	ImmutabilityPolicyState	Blob kapsayıcısının ImmutabilityPolicy durumu, olası değerler şunlardır: Kilitli ve Kilidi Açıldı.
updateHistory	UpdateHistoryProperty[]	Blob kapsayıcısının ImmutabilityPolicy güncelleştirme geçmişi.

ImmutabilityPolicyState

Listeleme

Blob kapsayıcısının ImmutabilityPolicy durumu, olası değerler şunlardır: Kilitli ve Kilidi Açıldı.

Değer	Description
Locked
Unlocked

ImmutabilityPolicyUpdateType

Listeleme

Blob kapsayıcısının ImmutabilityPolicy güncelleştirme türü, olası değerler şunlardır: put, lock ve extend.

Değer	Description
put
lock
extend

ImmutableStorageWithVersioning

Object

Kapsayıcının nesne düzeyinde değişmezlik özellikleri.

Name	Tür	Description
enabled	boolean	Bu sabit bir özelliktir, true olarak ayarlandığında kapsayıcı düzeyinde nesne düzeyinde değişmezliği etkinleştirir.
migrationState	MigrationState	Bu özellik, kapsayıcı düzeyinde nesne düzeyinde değişmezlik geçiş durumunu belirtir.
timeStamp	string (date-time)	Nesne düzeyinde değişmezliğin etkinleştirildiği tarih ve saati döndürür.

LeaseDuration

Listeleme

Bir kapsayıcıdaki kiralamanın sonsuz mu yoksa sabit bir süre mi olduğunu, yalnızca kapsayıcı kiralandığında belirtir.

Değer	Description
Infinite
Fixed

LeaseState

Listeleme

Kapsayıcının kira durumu.

Değer	Description
Available
Leased
Expired
Breaking
Broken

LeaseStatus

Listeleme

Kapsayıcının kira durumu.

Değer	Description
Locked
Unlocked

LegalHoldProperties

Object

Blob kapsayıcısının LegalHold özelliği.

Name	Tür	Description
hasLegalHold	boolean	HasLegalHold ortak özelliği, en az bir mevcut etiket varsa SRP tarafından true olarak ayarlanır. Mevcut tüm yasal tutma etiketleri temizlenirse hasLegalHold ortak özelliği SRP tarafından false olarak ayarlanır. Belirli bir hesap için hasLegalHold=true olan en fazla 1000 blob kapsayıcısı olabilir.
protectedAppendWritesHistory	ProtectedAppendWritesHistory	Korumalı ekleme blob yazma geçmişi.
tags	TagProperty[]	Blob kapsayıcısının LegalHold etiketlerinin listesi.

MigrationState

Listeleme

Bu özellik, kapsayıcı düzeyinde nesne düzeyinde değişmezlik geçiş durumunu belirtir.

Değer	Description
InProgress
Completed

ProtectedAppendWritesHistory

Object

Yasal tutmalar içeren blob kapsayıcısı için korumalı ekleme yazma geçmişi ayarı.

Name	Tür	Description
allowProtectedAppendWritesAll	boolean	Etkinleştirildiğinde, yasal koruma ve uyumluluk korunurken yeni bloklar hem 'Ekleme hem de Bock Bloblarına' yazılabilir. Yalnızca yeni bloklar eklenebilir ve mevcut bloklar değiştirilemez veya silinemez.
timestamp	string (date-time)	Etiketin eklendiği tarih ve saati döndürür.

PublicAccess

Listeleme

Kapsayıcıdaki verilere genel olarak erişilip erişilemeyeceğini ve erişim düzeyini belirtir.

Değer	Description
Container
Blob
None

TagProperty

Object

Blob kapsayıcısının LegalHold etiketi.

Name	Tür	Description
objectIdentifier	string	Etiketi ekleyen kullanıcının Nesne Kimliğini döndürür.
tag	string	Etiket değeri.
tenantId	string	Etiketi ekleyen kullanıcı için belirteci veren Kiracı Kimliğini döndürür.
timestamp	string (date-time)	Etiketin eklendiği tarih ve saati döndürür.
upn	string	Etiketi ekleyen kullanıcının Kullanıcı Asıl Adını döndürür.

UpdateHistoryProperty

Object

Blob kapsayıcısının ImmutabilityPolicy güncelleştirme geçmişi.

Name	Tür	Description
allowProtectedAppendWrites	boolean	Bu özellik yalnızca kilidi açılmış zamana bağlı saklama ilkeleri için değiştirilebilir. Etkinleştirildiğinde, değişmezlik koruması ve uyumluluğu korunurken ekleme blobuna yeni bloklar yazılabilir. Yalnızca yeni bloklar eklenebilir ve mevcut bloklar değiştirilemez veya silinemez. Bu özellik ExtendImmutabilityPolicy API'siyle değiştirilemez.
allowProtectedAppendWritesAll	boolean	Bu özellik yalnızca kilidi açılmış zamana bağlı saklama ilkeleri için değiştirilebilir. Etkinleştirildiğinde, değişmezlik koruması ve uyumluluğu korunurken yeni bloklar hem 'Ekleme hem de Bock Bloblarına' yazılabilir. Yalnızca yeni bloklar eklenebilir ve mevcut bloklar değiştirilemez veya silinemez. Bu özellik ExtendImmutabilityPolicy API'siyle değiştirilemez. 'allowProtectedAppendWrites' ve 'allowProtectedAppendWritesAll' özellikleri birbirini dışlar.
immutabilityPeriodSinceCreationInDays	integer	İlke oluşturma işleminden bu yana kapsayıcıdaki bloblar için gün cinsinden değişmezlik süresi.
objectIdentifier	string	ImmutabilityPolicy'yi güncelleştiren kullanıcının Nesne Kimliğini döndürür.
tenantId	string	ImmutabilityPolicy'yi güncelleştiren kullanıcı için belirteci veren Kiracı Kimliğini döndürür.
timestamp	string (date-time)	ImmutabilityPolicy'nin güncelleştirilmiş olduğu tarih ve saati döndürür.
update	ImmutabilityPolicyUpdateType	Blob kapsayıcısının ImmutabilityPolicy güncelleştirme türü, olası değerler şunlardır: put, lock ve extend.
upn	string	ImmutabilityPolicy'yi güncelleştiren kullanıcının Kullanıcı Asıl Adını döndürür.