다음을 통해 공유


Blob Services - Set Service Properties

스토리지 분석 및 CORS(원본 간 리소스 공유) 규칙에 대한 속성을 포함하여 스토리지 계정의 Blob Service 속성을 설정합니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

지정된 리소스 그룹 내의 스토리지 계정 이름입니다. 스토리지 계정 이름은 길이가 3자에서 24자 사이여야 하며 숫자와 소문자만 사용해야 합니다.

BlobServicesName
path True

BlobServicesName

지정된 스토리지 계정 내의 Blob Service 이름입니다. Blob 서비스 이름은 '기본값'이어야 합니다.

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

사용자의 구독 내에 있는 리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.

subscriptionId
path True

string

minLength: 1

대상 구독의 ID입니다.

api-version
query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

요청 본문

Name 형식 Description
properties.automaticSnapshotPolicyEnabled

boolean

isVersioningEnabled 속성을 위해 사용되지 않습니다.

properties.changeFeed

ChangeFeed

변경 피드 이벤트에 대한 Blob 서비스 속성입니다.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

컨테이너 일시 삭제에 대한 Blob 서비스 속성입니다.

properties.cors

CorsRules

Blob 서비스에 대한 CORS 규칙을 지정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. 요청 본문에 CorsRule 요소가 포함되지 않으면 모든 CORS 규칙이 삭제되고 Blob 서비스에 대해 CORS가 비활성화됩니다.

properties.defaultServiceVersion

string

DefaultServiceVersion은 들어오는 요청의 버전이 지정되지 않은 경우 Blob 서비스에 대한 요청에 사용할 기본 버전을 나타냅니다. 가능한 값에는 버전 2008-10-27 및 모든 최신 버전이 포함됩니다.

properties.deleteRetentionPolicy

DeleteRetentionPolicy

Blob 일시 삭제에 대한 Blob 서비스 속성입니다.

properties.isVersioningEnabled

boolean

true로 설정하면 버전 관리가 활성화됩니다.

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

마지막 액세스 시간 기반 추적 정책을 구성하는 Blob 서비스 속성입니다.

properties.restorePolicy

RestorePolicyProperties

Blob 복원 정책에 대한 Blob 서비스 속성입니다.

응답

Name 형식 Description
200 OK

BlobServiceProperties

확인 -- 스토리지 계정의 Blob 서비스의 속성을 성공적으로 설정합니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

BlobServicesPutAllowPermanentDelete
BlobServicesPutLastAccessTimeBasedTracking
PutBlobServices

BlobServicesPutAllowPermanentDelete

샘플 요청

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

{
  "properties": {
    "deleteRetentionPolicy": {
      "enabled": true,
      "days": 300,
      "allowPermanentDelete": true
    },
    "isVersioningEnabled": true
  }
}

샘플 응답

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/blobServices",
  "properties": {
    "deleteRetentionPolicy": {
      "enabled": true,
      "days": 300,
      "allowPermanentDelete": true
    },
    "isVersioningEnabled": true
  }
}

BlobServicesPutLastAccessTimeBasedTracking

샘플 요청

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

{
  "properties": {
    "lastAccessTimeTrackingPolicy": {
      "enable": true,
      "name": "AccessTimeTracking",
      "trackingGranularityInDays": 1,
      "blobType": [
        "blockBlob"
      ]
    }
  }
}

샘플 응답

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/blobServices",
  "properties": {
    "lastAccessTimeTrackingPolicy": {
      "enable": true,
      "name": "AccessTimeTracking",
      "trackingGranularityInDays": 1,
      "blobType": [
        "blockBlob"
      ]
    }
  }
}

PutBlobServices

샘플 요청

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

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

샘플 응답

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

정의

Name Description
AllowedMethods

CorsRule 요소가 있는 경우 필수입니다. 원본에서 실행할 수 있는 HTTP 메서드 목록입니다.

BlobServiceProperties

스토리지 계정의 Blob 서비스의 속성입니다.

BlobServicesName

지정된 스토리지 계정 내의 Blob Service 이름입니다. Blob 서비스 이름은 '기본값'이어야 합니다.

ChangeFeed

변경 피드 이벤트에 대한 Blob 서비스 속성입니다.

CorsRule

Blob 서비스에 대한 CORS 규칙을 지정합니다.

CorsRules

CORS 규칙을 설정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다.

DeleteRetentionPolicy

일시 삭제에 대한 서비스 속성입니다.

LastAccessTimeTrackingPolicy

마지막 액세스 시간 기반 추적 정책에 대한 Blob 서비스 속성입니다.

name

정책의 이름입니다. 유효한 값은 AccessTimeTracking입니다. 이 필드는 현재 읽기 전용입니다.

RestorePolicyProperties

Blob 복원 정책에 대한 Blob 서비스 속성

Sku

스토리지 계정의 SKU입니다.

SkuName

SKU 이름입니다. 계정을 만드는 데 필요합니다. 업데이트에 대한 선택 사항입니다. 이전 버전에서는 SKU 이름을 accountType이라고 했습니다.

SkuTier

SKU 레벨. 이는 SKU 이름을 기반으로 합니다.

AllowedMethods

CorsRule 요소가 있는 경우 필수입니다. 원본에서 실행할 수 있는 HTTP 메서드 목록입니다.

Description
DELETE
GET
HEAD
MERGE
POST
OPTIONS
PUT
PATCH
CONNECT
TRACE

BlobServiceProperties

스토리지 계정의 Blob 서비스의 속성입니다.

Name 형식 Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

리소스의 이름

properties.automaticSnapshotPolicyEnabled

boolean

isVersioningEnabled 속성을 위해 사용되지 않습니다.

properties.changeFeed

ChangeFeed

변경 피드 이벤트에 대한 Blob 서비스 속성입니다.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

컨테이너 일시 삭제에 대한 Blob 서비스 속성입니다.

properties.cors

CorsRules

Blob 서비스에 대한 CORS 규칙을 지정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. 요청 본문에 CorsRule 요소가 포함되지 않으면 모든 CORS 규칙이 삭제되고 Blob 서비스에 대해 CORS가 비활성화됩니다.

properties.defaultServiceVersion

string

DefaultServiceVersion은 들어오는 요청의 버전이 지정되지 않은 경우 Blob 서비스에 대한 요청에 사용할 기본 버전을 나타냅니다. 가능한 값에는 버전 2008-10-27 및 모든 최신 버전이 포함됩니다.

properties.deleteRetentionPolicy

DeleteRetentionPolicy

Blob 일시 삭제에 대한 Blob 서비스 속성입니다.

properties.isVersioningEnabled

boolean

true로 설정하면 버전 관리가 활성화됩니다.

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

마지막 액세스 시간 기반 추적 정책을 구성하는 Blob 서비스 속성입니다.

properties.restorePolicy

RestorePolicyProperties

Blob 복원 정책에 대한 Blob 서비스 속성입니다.

sku

Sku

Sku 이름 및 계층입니다.

type

string

리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

BlobServicesName

지정된 스토리지 계정 내의 Blob Service 이름입니다. Blob 서비스 이름은 '기본값'이어야 합니다.

Description
default

ChangeFeed

변경 피드 이벤트에 대한 Blob 서비스 속성입니다.

Name 형식 Description
enabled

boolean

Blob 서비스에 대해 변경 피드 이벤트 로깅을 사용할 수 있는지 여부를 나타냅니다.

retentionInDays

integer (int32)

minimum: 1
maximum: 146000

changeFeed 보존 기간(일)을 나타냅니다. 최소값은 1일이고 최대값은 146000일(400년)입니다. null 값은 변경 피드의 무한 보존을 나타냅니다.

CorsRule

Blob 서비스에 대한 CORS 규칙을 지정합니다.

Name 형식 Description
allowedHeaders

string[]

CorsRule 요소가 있는 경우 필수입니다. 원본 간 요청의 일부가 될 수 있는 헤더 목록입니다.

allowedMethods

AllowedMethods[]

CorsRule 요소가 있는 경우 필수입니다. 원본에서 실행할 수 있는 HTTP 메서드 목록입니다.

allowedOrigins

string[]

CorsRule 요소가 있는 경우 필수입니다. CORS를 통해 허용되는 원본 도메인 목록 또는 모든 도메인을 허용하는 "*"입니다.

exposedHeaders

string[]

CorsRule 요소가 있는 경우 필수입니다. CORS 클라이언트에 노출할 응답 헤더 목록입니다.

maxAgeInSeconds

integer

CorsRule 요소가 있는 경우 필수입니다. 클라이언트/브라우저가 실행 전 응답을 캐시해야 하는 시간(초)입니다.

CorsRules

CORS 규칙을 설정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다.

Name 형식 Description
corsRules

CorsRule[]

CORS 규칙 목록입니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다.

DeleteRetentionPolicy

일시 삭제에 대한 서비스 속성입니다.

Name 형식 Description
allowPermanentDelete

boolean

true로 설정된 경우 이 속성을 사용하면 일시 삭제된 Blob 버전 및 스냅샷을 삭제할 수 있습니다. 이 속성은 Blob 복원 정책을 사용할 수 없습니다. 이 속성은 Blob 서비스에만 적용되며 컨테이너 또는 파일 공유에는 적용되지 않습니다.

days

integer

minimum: 1
maximum: 365

삭제된 항목을 보존해야 하는 일 수를 나타냅니다. 지정된 최소값은 1이고 최대값은 365일 수 있습니다.

enabled

boolean

DeleteRetentionPolicy를 사용할 수 있는지 여부를 나타냅니다.

LastAccessTimeTrackingPolicy

마지막 액세스 시간 기반 추적 정책에 대한 Blob 서비스 속성입니다.

Name 형식 Description
blobType

string[]

미리 정의된 지원되는 Blob 형식의 배열입니다. blockBlob만 지원되는 값입니다. 이 필드는 현재 읽기 전용입니다.

enable

boolean

true로 설정된 경우 마지막 액세스 시간 기반 추적을 사용하도록 설정됩니다.

name

name

정책의 이름입니다. 유효한 값은 AccessTimeTracking입니다. 이 필드는 현재 읽기 전용입니다.

trackingGranularityInDays

integer (int32)

필드는 Blob 개체 추적 세분성(일반적으로 Blob 개체를 추적해야 하는 빈도)을 지정합니다. 이 필드는 현재 값이 1인 경우에만 읽습니다.

name

정책의 이름입니다. 유효한 값은 AccessTimeTracking입니다. 이 필드는 현재 읽기 전용입니다.

Description
AccessTimeTracking

RestorePolicyProperties

Blob 복원 정책에 대한 Blob 서비스 속성

Name 형식 Description
days

integer

minimum: 1
maximum: 365

이 Blob을 복원할 수 있는 기간입니다. 0보다 크고 DeleteRetentionPolicy.days보다 작아야 합니다.

enabled

boolean

true로 설정하면 Blob 복원이 활성화됩니다.

lastEnabledTime

string (date-time)

minRestoreTime 속성을 위해 사용되지 않습니다.

minRestoreTime

string (date-time)

복원을 시작할 수 있는 최소 날짜 및 시간을 반환합니다.

Sku

스토리지 계정의 SKU입니다.

Name 형식 Description
name

SkuName

SKU 이름입니다. 계정을 만드는 데 필요합니다. 업데이트에 대한 선택 사항입니다. 이전 버전에서는 SKU 이름을 accountType이라고 했습니다.

tier

SkuTier

SKU 레벨. 이는 SKU 이름을 기반으로 합니다.

SkuName

SKU 이름입니다. 계정을 만드는 데 필요합니다. 업데이트에 대한 선택 사항입니다. 이전 버전에서는 SKU 이름을 accountType이라고 했습니다.

Description
Standard_LRS
Standard_GRS
Standard_RAGRS
Standard_ZRS
Premium_LRS
Premium_ZRS
Standard_GZRS
Standard_RAGZRS
StandardV2_LRS
StandardV2_GRS
StandardV2_ZRS
StandardV2_GZRS
PremiumV2_LRS
PremiumV2_ZRS

SkuTier

SKU 레벨. 이는 SKU 이름을 기반으로 합니다.

Description
Standard
Premium