Blob Services - Get Service Properties

Szolgáltatás:

Storage Resource Provider

API-verzió:

2024-01-01

Lekéri a tárfiók Blob szolgáltatásának tulajdonságait, beleértve a Storage Analytics és a CORS (forrásközi erőforrás-megosztás) szabályok tulajdonságait is.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	A tárfiók neve a megadott erőforráscsoporton belül. A tárfiókok nevének 3 és 24 karakter közötti hosszúságúnak kell lennie, és csak számokat és kisbetűket kell használnia.
BlobServicesName	path	True	BlobServicesName	A blobszolgáltatás neve a megadott tárfiókon belül. A blobszolgáltatás nevének alapértelmezettnek kell lennie
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._\(\)]+$	A felhasználó előfizetésében lévő erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string minLength: 1	A cél-előfizetés azonosítója.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Válaszok

Name	Típus	Description
200 OK	BlobServiceProperties	OK – visszaadta a tárfiók Blob szolgáltatásának tulajdonságait.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

GetBlobServices

Mintakérelem

HTTP

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

Java

/**
 * Samples for BlobServices GetServiceProperties.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/storage/resource-manager/Microsoft.Storage/stable/2024-01-01/examples/BlobServicesGet.json
     */
    /**
     * Sample code: GetBlobServices.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getBlobServices(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.storageAccounts().manager().serviceClient().getBlobServices().getServicePropertiesWithResponse("res4410",
            "sto8607", 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_services_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_services.get_service_properties(
        resource_group_name="res4410",
        account_name="sto8607",
    )
    print(response)


# x-ms-original-file: specification/storage/resource-manager/Microsoft.Storage/stable/2024-01-01/examples/BlobServicesGet.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/97ee23a6db6078abcbec7b75bf9af8c503e9bb8b/specification/storage/resource-manager/Microsoft.Storage/stable/2024-01-01/examples/BlobServicesGet.json
func ExampleBlobServicesClient_GetServiceProperties() {
	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.NewBlobServicesClient().GetServiceProperties(ctx, "res4410", "sto8607", 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.BlobServiceProperties = armstorage.BlobServiceProperties{
	// 	Name: to.Ptr("default"),
	// 	Type: to.Ptr("Microsoft.Storage/storageAccounts/blobServices"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default"),
	// 	BlobServiceProperties: &armstorage.BlobServicePropertiesProperties{
	// 		ChangeFeed: &armstorage.ChangeFeed{
	// 			Enabled: to.Ptr(true),
	// 			RetentionInDays: to.Ptr[int32](7),
	// 		},
	// 		Cors: &armstorage.CorsRules{
	// 			CorsRules: []*armstorage.CorsRule{
	// 				{
	// 					AllowedHeaders: []*string{
	// 						to.Ptr("x-ms-meta-abc"),
	// 						to.Ptr("x-ms-meta-data*"),
	// 						to.Ptr("x-ms-meta-target*")},
	// 						AllowedMethods: []*armstorage.CorsRuleAllowedMethodsItem{
	// 							to.Ptr(armstorage.CorsRuleAllowedMethodsItemGET),
	// 							to.Ptr(armstorage.CorsRuleAllowedMethodsItemHEAD),
	// 							to.Ptr(armstorage.CorsRuleAllowedMethodsItemPOST),
	// 							to.Ptr(armstorage.CorsRuleAllowedMethodsItemOPTIONS),
	// 							to.Ptr(armstorage.CorsRuleAllowedMethodsItemMERGE),
	// 							to.Ptr(armstorage.CorsRuleAllowedMethodsItemPUT)},
	// 							AllowedOrigins: []*string{
	// 								to.Ptr("http://www.contoso.com"),
	// 								to.Ptr("http://www.fabrikam.com")},
	// 								ExposedHeaders: []*string{
	// 									to.Ptr("x-ms-meta-*")},
	// 									MaxAgeInSeconds: to.Ptr[int32](100),
	// 								},
	// 								{
	// 									AllowedHeaders: []*string{
	// 										to.Ptr("*")},
	// 										AllowedMethods: []*armstorage.CorsRuleAllowedMethodsItem{
	// 											to.Ptr(armstorage.CorsRuleAllowedMethodsItemGET)},
	// 											AllowedOrigins: []*string{
	// 												to.Ptr("*")},
	// 												ExposedHeaders: []*string{
	// 													to.Ptr("*")},
	// 													MaxAgeInSeconds: to.Ptr[int32](2),
	// 												},
	// 												{
	// 													AllowedHeaders: []*string{
	// 														to.Ptr("x-ms-meta-12345675754564*")},
	// 														AllowedMethods: []*armstorage.CorsRuleAllowedMethodsItem{
	// 															to.Ptr(armstorage.CorsRuleAllowedMethodsItemGET),
	// 															to.Ptr(armstorage.CorsRuleAllowedMethodsItemPUT)},
	// 															AllowedOrigins: []*string{
	// 																to.Ptr("http://www.abc23.com"),
	// 																to.Ptr("https://www.fabrikam.com/*")},
	// 																ExposedHeaders: []*string{
	// 																	to.Ptr("x-ms-meta-abc"),
	// 																	to.Ptr("x-ms-meta-data*"),
	// 																	to.Ptr("x -ms-meta-target*")},
	// 																	MaxAgeInSeconds: to.Ptr[int32](2000),
	// 															}},
	// 														},
	// 														DefaultServiceVersion: to.Ptr("2017-07-29"),
	// 														DeleteRetentionPolicy: &armstorage.DeleteRetentionPolicy{
	// 															Days: to.Ptr[int32](300),
	// 															Enabled: to.Ptr(true),
	// 														},
	// 														IsVersioningEnabled: to.Ptr(true),
	// 													},
	// 													SKU: &armstorage.SKU{
	// 														Name: to.Ptr(armstorage.SKUNameStandardGRS),
	// 														Tier: to.Ptr(armstorage.SKUTierStandard),
	// 													},
	// 												}
}

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 the properties of a storage account’s Blob service, including properties for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules.
 *
 * @summary Gets the properties of a storage account’s Blob service, including properties for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules.
 * x-ms-original-file: specification/storage/resource-manager/Microsoft.Storage/stable/2024-01-01/examples/BlobServicesGet.json
 */
async function getBlobServices() {
  const subscriptionId = process.env["STORAGE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["STORAGE_RESOURCE_GROUP"] || "res4410";
  const accountName = "sto8607";
  const credential = new DefaultAzureCredential();
  const client = new StorageManagementClient(credential, subscriptionId);
  const result = await client.blobServices.getServiceProperties(resourceGroupName, accountName);
  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/BlobServicesGet.json
// this example is just showing the usage of "BlobServices_GetServiceProperties" 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 = "res4410";
string accountName = "sto8607";
ResourceIdentifier blobServiceResourceId = BlobServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName);
BlobServiceResource blobService = client.GetBlobServiceResource(blobServiceResourceId);

// invoke the operation
BlobServiceResource result = await blobService.GetAsync();

// 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
BlobServiceData 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

Mintaválasz

Állapotkód:

200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/blobServices",
  "properties": {
    "cors": {
      "corsRules": [
        {
          "allowedOrigins": [
            "http://www.contoso.com",
            "http://www.fabrikam.com"
          ],
          "allowedMethods": [
            "GET",
            "HEAD",
            "POST",
            "OPTIONS",
            "MERGE",
            "PUT"
          ],
          "maxAgeInSeconds": 100,
          "exposedHeaders": [
            "x-ms-meta-*"
          ],
          "allowedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ]
        },
        {
          "allowedOrigins": [
            "*"
          ],
          "allowedMethods": [
            "GET"
          ],
          "maxAgeInSeconds": 2,
          "exposedHeaders": [
            "*"
          ],
          "allowedHeaders": [
            "*"
          ]
        },
        {
          "allowedOrigins": [
            "http://www.abc23.com",
            "https://www.fabrikam.com/*"
          ],
          "allowedMethods": [
            "GET",
            "PUT"
          ],
          "maxAgeInSeconds": 2000,
          "exposedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x -ms-meta-target*"
          ],
          "allowedHeaders": [
            "x-ms-meta-12345675754564*"
          ]
        }
      ]
    },
    "defaultServiceVersion": "2017-07-29",
    "deleteRetentionPolicy": {
      "enabled": true,
      "days": 300
    },
    "isVersioningEnabled": true,
    "changeFeed": {
      "enabled": true,
      "retentionInDays": 7
    }
  },
  "sku": {
    "name": "Standard_GRS",
    "tier": "Standard"
  }
}

Definíciók

Name	Description
AllowedMethods	CorsRule elem esetén kötelező megadni. A forrás által végrehajtható HTTP-metódusok listája.
BlobServiceProperties	A tárfiók Blob szolgáltatásának tulajdonságai.
BlobServicesName	A blobszolgáltatás neve a megadott tárfiókon belül. A blobszolgáltatás nevének alapértelmezettnek kell lennie
ChangeFeed	A blobszolgáltatás tulajdonságai a változáscsatorna-eseményekhez.
CorsRule	A Blob szolgáltatás CORS-szabályát adja meg.
CorsRules	Beállítja a CORS-szabályokat. Legfeljebb öt CorsRule-elemet vehet fel a kérelembe.
DeleteRetentionPolicy	A helyreállítható törlés szolgáltatástulajdonságai.
LastAccessTimeTrackingPolicy	A blobszolgáltatás tulajdonságai a legutóbbi hozzáférés időalapú nyomkövetési szabályzatához.
name	A szabályzat neve. Az érvényes érték az AccessTimeTracking. Ez a mező jelenleg csak olvasható
RestorePolicyProperties	A blobszolgáltatás tulajdonságai a blob-visszaállítási szabályzathoz
Sku	A tárfiók termékváltozata.
SkuName	Az termékváltozat neve. A fióklétrehozáshoz szükséges; nem kötelező a frissítéshez. Vegye figyelembe, hogy a régebbi verziókban a termékváltozat neve accountType volt.
SkuTier	Az SKU-szint (raktározási egység kód szintje). Ez a termékváltozat neve alapján történik.

AllowedMethods

Enumerálás

CorsRule elem esetén kötelező megadni. A forrás által végrehajtható HTTP-metódusok listája.

Érték	Description
CONNECT
DELETE
GET
HEAD
MERGE
OPTIONS
PATCH
POST
PUT
TRACE

BlobServiceProperties

Objektum

A tárfiók Blob szolgáltatásának tulajdonságai.

Name	Típus	Description
id	string	Az erőforrás teljes erőforrás-azonosítója. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Az erőforrás neve
properties.automaticSnapshotPolicyEnabled	boolean	Az isVersioningEnabled tulajdonság javára elavult.
properties.changeFeed	ChangeFeed	A blobszolgáltatás tulajdonságai a változáscsatorna-eseményekhez.
properties.containerDeleteRetentionPolicy	DeleteRetentionPolicy	A tároló helyreállítható törlésének blobszolgáltatás-tulajdonságai.
properties.cors	CorsRules	A Blob szolgáltatás CORS-szabályait adja meg. Legfeljebb öt CorsRule-elemet vehet fel a kérelembe. Ha a kérelemtörzs nem tartalmaz CorsRule-elemeket, az összes CORS-szabály törlődik, és a CORS le lesz tiltva a Blob szolgáltatásban.
properties.defaultServiceVersion	string	A DefaultServiceVersion azt az alapértelmezett verziót jelzi, amelyet a blobszolgáltatáshoz érkező kérésekhez használni kell, ha nincs megadva egy bejövő kérés verziója. A lehetséges értékek közé tartozik a 2008-10-27-es verzió és az összes újabb verzió.
properties.deleteRetentionPolicy	DeleteRetentionPolicy	A blobszolgáltatás tulajdonságai a helyreállítható blob törléséhez.
properties.isVersioningEnabled	boolean	A verziószámozás engedélyezve van, ha igaz értékre van állítva.
properties.lastAccessTimeTrackingPolicy	LastAccessTimeTrackingPolicy	A blobszolgáltatás tulajdonsága a legutóbbi hozzáférési időalapú nyomkövetési szabályzat konfigurálásához.
properties.restorePolicy	RestorePolicyProperties	A blob-visszaállítási szabályzat blobszolgáltatás-tulajdonságai.
sku	Sku	Termékváltozat neve és szintje.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

BlobServicesName

Enumerálás

A blobszolgáltatás neve a megadott tárfiókon belül. A blobszolgáltatás nevének alapértelmezettnek kell lennie

Érték	Description
default

ChangeFeed

Objektum

A blobszolgáltatás tulajdonságai a változáscsatorna-eseményekhez.

Name	Típus	Description
enabled	boolean	Azt jelzi, hogy engedélyezve van-e a változáscsatorna eseménynaplózása a Blob szolgáltatásban.
retentionInDays	integer (int32) minimum: 1 maximum: 146000	A changeFeed adatmegőrzés időtartamát jelzi napokban. A minimális érték 1 nap, a maximális érték pedig 146000 nap (400 év). A null érték a változáscsatorna végtelen megőrzését jelzi.

CorsRule

Objektum

A Blob szolgáltatás CORS-szabályát adja meg.

Name	Típus	Description
allowedHeaders	string[]	CorsRule elem esetén kötelező megadni. A fejlécek listája, amely a forrásközi kérelem részét képezheti.
allowedMethods	AllowedMethods[]	CorsRule elem esetén kötelező megadni. A forrás által végrehajtható HTTP-metódusok listája.
allowedOrigins	string[]	CorsRule elem esetén kötelező megadni. A CORS-on keresztül engedélyezett forrástartományok listája vagy "*" az összes tartomány engedélyezéséhez
exposedHeaders	string[]	CorsRule elem esetén kötelező megadni. A CORS-ügyfelek számára közzéteendő válaszfejlécek listája.
maxAgeInSeconds	integer	CorsRule elem esetén kötelező megadni. Azon másodpercek száma, amikor az ügyfélnek/böngészőnek gyorsítótárba kell helyeznie az elővizsgálati választ.

CorsRules

Objektum

Beállítja a CORS-szabályokat. Legfeljebb öt CorsRule-elemet vehet fel a kérelembe.

Name	Típus	Description
corsRules	CorsRule[]	A CORS-szabályok listája. Legfeljebb öt CorsRule-elemet vehet fel a kérelembe.

DeleteRetentionPolicy

Objektum

A helyreállítható törlés szolgáltatástulajdonságai.

Name	Típus	Description
allowPermanentDelete	boolean	Ez a tulajdonság, ha igaz értékre van állítva, lehetővé teszi a helyreállíthatóan törölt blobverziók és pillanatképek törlését. Ez a tulajdonság nem használható blob-visszaállítási szabályzattal. Ez a tulajdonság csak a blobszolgáltatásra vonatkozik, és nem vonatkozik a tárolókra vagy fájlmegosztásokra.
days	integer minimum: 1 maximum: 365	Azt jelzi, hogy hány napig kell megőrizni a törölt elemet. A minimálisan megadott érték 1 lehet, a maximális érték pedig 365.
enabled	boolean	Azt jelzi, hogy a DeleteRetentionPolicy engedélyezve van-e.

LastAccessTimeTrackingPolicy

Objektum

A blobszolgáltatás tulajdonságai a legutóbbi hozzáférés időalapú nyomkövetési szabályzatához.

Name	Típus	Description
blobType	string[]	Előre definiált támogatott blobtípusok tömbje. Csak a blockBlob a támogatott érték. Ez a mező jelenleg csak olvasható
enable	boolean	Ha igaz utolsó hozzáférési időre van állítva, engedélyezve van a nyomon követés.
name	name	A szabályzat neve. Az érvényes érték az AccessTimeTracking. Ez a mező jelenleg csak olvasható
trackingGranularityInDays	integer (int32)	A mező napok alatt határozza meg a blobobjektumok nyomon követésének részletességét, jellemzően a blobobjektum nyomon követésének gyakoriságát. Ez a mező jelenleg csak 1 értékkel olvasható

name

Enumerálás

A szabályzat neve. Az érvényes érték az AccessTimeTracking. Ez a mező jelenleg csak olvasható

Érték	Description
AccessTimeTracking

RestorePolicyProperties

Objektum

A blobszolgáltatás tulajdonságai a blob-visszaállítási szabályzathoz

Name	Típus	Description
days	integer minimum: 1 maximum: 365	mennyi ideig állítható vissza ez a blob. A DeleteRetentionPolicy.days értéknél nagyobbnak és nullánál kisebbnek kell lennie.
enabled	boolean	A blobok visszaállítása engedélyezve van, ha igaz értékre van állítva.
lastEnabledTime	string (date-time)	Elavult a minRestoreTime tulajdonság javára.
minRestoreTime	string (date-time)	A visszaállítás indításának minimális dátumát és időpontját adja vissza.

Sku

Objektum

A tárfiók termékváltozata.

Name	Típus	Description
name	SkuName	Az termékváltozat neve. A fióklétrehozáshoz szükséges; nem kötelező a frissítéshez. Vegye figyelembe, hogy a régebbi verziókban a termékváltozat neve accountType volt.
tier	SkuTier	Az SKU-szint (raktározási egység kód szintje). Ez a termékváltozat neve alapján történik.

SkuName

Enumerálás

Az termékváltozat neve. A fióklétrehozáshoz szükséges; nem kötelező a frissítéshez. Vegye figyelembe, hogy a régebbi verziókban a termékváltozat neve accountType volt.

Érték	Description
PremiumV2_LRS
PremiumV2_ZRS
Premium_LRS
Premium_ZRS
StandardV2_GRS
StandardV2_GZRS
StandardV2_LRS
StandardV2_ZRS
Standard_GRS
Standard_GZRS
Standard_LRS
Standard_RAGRS
Standard_RAGZRS
Standard_ZRS

SkuTier

Enumerálás

Az SKU-szint (raktározási egység kód szintje). Ez a termékváltozat neve alapján történik.

Érték	Description
Premium
Standard