Blob Services - Set Service Properties
스토리지 분석 및 CORS(원본 간 리소스 공유) 규칙에 대한 속성을 포함하여 스토리지 계정의 Blob 서비스의 속성을 설정합니다.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2023-01-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
account
|
path | True |
string |
지정된 리소스 그룹 내의 스토리지 계정 이름입니다. Storage 계정 이름은 3자에서 24자 사이여야 하고 숫자 및 소문자만 사용해야 합니다. Regex pattern: |
Blob
|
path | True |
지정된 스토리지 계정 내의 Blob Service 이름입니다. Blob 서비스 이름은 '기본값'이어야 합니다. |
|
resource
|
path | True |
string |
사용자의 구독 내에 있는 리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다. Regex pattern: |
subscription
|
path | True |
string |
대상 구독의 ID입니다. |
api-version
|
query | True |
string |
이 작업에 사용할 API 버전입니다. |
요청 본문
Name | 형식 | Description |
---|---|---|
properties.automaticSnapshotPolicyEnabled |
boolean |
isVersioningEnabled 속성에 더 이상 사용되지 않습니다. |
properties.changeFeed |
변경 피드 이벤트에 대한 Blob 서비스 속성입니다. |
|
properties.containerDeleteRetentionPolicy |
컨테이너 일시 삭제에 대한 Blob 서비스 속성입니다. |
|
properties.cors |
Blob 서비스에 대한 CORS 규칙을 지정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. 요청 본문에 CorsRule 요소가 포함되지 않으면 모든 CORS 규칙이 삭제되고 Blob 서비스에 대해 CORS가 비활성화됩니다. |
|
properties.defaultServiceVersion |
string |
DefaultServiceVersion은 들어오는 요청의 버전이 지정되지 않은 경우 Blob 서비스에 대한 요청에 사용할 기본 버전을 나타냅니다. 가능한 값에는 2008-10-27 및 모든 최신 버전이 포함됩니다. |
properties.deleteRetentionPolicy |
Blob 일시 삭제에 대한 Blob 서비스 속성입니다. |
|
properties.isVersioningEnabled |
boolean |
true로 설정하면 버전 관리를 사용할 수 있습니다. |
properties.lastAccessTimeTrackingPolicy |
마지막 액세스 시간 기반 추적 정책을 구성하는 Blob 서비스 속성입니다. |
|
properties.restorePolicy |
Blob 복원 정책에 대한 Blob 서비스 속성입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
확인 -- 스토리지 계정의 Blob 서비스의 속성을 설정합니다. |
보안
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | 사용자 계정 가장 |
예제
Blob |
Blob |
Put |
BlobServicesPutAllowPermanentDelete
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2023-01-01
{
"properties": {
"deleteRetentionPolicy": {
"enabled": true,
"days": 300,
"allowPermanentDelete": true
},
"isVersioningEnabled": true
}
}
Sample Response
{
"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
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2023-01-01
{
"properties": {
"lastAccessTimeTrackingPolicy": {
"enable": true,
"name": "AccessTimeTracking",
"trackingGranularityInDays": 1,
"blobType": [
"blockBlob"
]
}
}
}
Sample Response
{
"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
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2023-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
}
}
}
Sample Response
{
"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 |
---|---|
Allowed |
CorsRule 요소가 있는 경우 필요합니다. 원본에서 실행할 수 있는 HTTP 메서드 목록입니다. |
Blob |
스토리지 계정의 Blob 서비스의 속성입니다. |
Blob |
지정된 스토리지 계정 내의 Blob Service 이름입니다. Blob 서비스 이름은 '기본값'이어야 합니다. |
Change |
변경 피드 이벤트에 대한 Blob 서비스 속성입니다. |
Cors |
Blob 서비스에 대한 CORS 규칙을 지정합니다. |
Cors |
CORS 규칙을 설정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. |
Delete |
일시 삭제에 대한 서비스 속성입니다. |
Last |
마지막 액세스 시간 기반 추적 정책에 대한 Blob 서비스 속성입니다. |
name |
정책의 이름입니다. 유효한 값은 AccessTimeTracking입니다. 이 필드는 현재 읽기 전용입니다. |
Restore |
Blob 복원 정책에 대한 Blob 서비스 속성 |
Sku |
스토리지 계정의 SKU입니다. |
Sku |
SKU 이름입니다. 계정을 만드는 데 필요합니다. 업데이트에 대한 선택 사항입니다. 이전 버전에서는 SKU 이름을 accountType이라고 했습니다. |
Sku |
SKU 계층. 이는 SKU 이름을 기반으로 합니다. |
AllowedMethods
CorsRule 요소가 있는 경우 필요합니다. 원본에서 실행할 수 있는 HTTP 메서드 목록입니다.
Name | 형식 | Description |
---|---|---|
CONNECT |
string |
|
DELETE |
string |
|
GET |
string |
|
HEAD |
string |
|
MERGE |
string |
|
OPTIONS |
string |
|
PATCH |
string |
|
POST |
string |
|
PUT |
string |
|
TRACE |
string |
BlobServiceProperties
스토리지 계정의 Blob 서비스의 속성입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
리소스의 이름입니다. |
properties.automaticSnapshotPolicyEnabled |
boolean |
isVersioningEnabled 속성에 더 이상 사용되지 않습니다. |
properties.changeFeed |
변경 피드 이벤트에 대한 Blob 서비스 속성입니다. |
|
properties.containerDeleteRetentionPolicy |
컨테이너 일시 삭제에 대한 Blob 서비스 속성입니다. |
|
properties.cors |
Blob 서비스에 대한 CORS 규칙을 지정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. 요청 본문에 CorsRule 요소가 포함되지 않으면 모든 CORS 규칙이 삭제되고 Blob 서비스에 대해 CORS가 비활성화됩니다. |
|
properties.defaultServiceVersion |
string |
DefaultServiceVersion은 들어오는 요청의 버전이 지정되지 않은 경우 Blob 서비스에 대한 요청에 사용할 기본 버전을 나타냅니다. 가능한 값에는 2008-10-27 및 모든 최신 버전이 포함됩니다. |
properties.deleteRetentionPolicy |
Blob 일시 삭제에 대한 Blob 서비스 속성입니다. |
|
properties.isVersioningEnabled |
boolean |
true로 설정하면 버전 관리를 사용할 수 있습니다. |
properties.lastAccessTimeTrackingPolicy |
마지막 액세스 시간 기반 추적 정책을 구성하는 Blob 서비스 속성입니다. |
|
properties.restorePolicy |
Blob 복원 정책에 대한 Blob 서비스 속성입니다. |
|
sku |
Sku 이름 및 계층. |
|
type |
string |
리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
BlobServicesName
지정된 스토리지 계정 내의 Blob Service 이름입니다. Blob 서비스 이름은 '기본값'이어야 합니다.
Name | 형식 | Description |
---|---|---|
default |
string |
ChangeFeed
변경 피드 이벤트에 대한 Blob 서비스 속성입니다.
Name | 형식 | Description |
---|---|---|
enabled |
boolean |
Blob 서비스에 대해 변경 피드 이벤트 로깅을 사용할 수 있는지 여부를 나타냅니다. |
retentionInDays |
integer |
changeFeed 보존 기간(일)을 나타냅니다. 최소값은 1일이고 최대값은 146000일(400년)입니다. null 값은 변경 피드의 무한 보존을 나타냅니다. |
CorsRule
Blob 서비스에 대한 CORS 규칙을 지정합니다.
Name | 형식 | Description |
---|---|---|
allowedHeaders |
string[] |
CorsRule 요소가 있는 경우 필요합니다. 원본 간 요청의 일부가 될 수 있는 헤더 목록입니다. |
allowedMethods |
CorsRule 요소가 있는 경우 필요합니다. 원본에서 실행할 수 있는 HTTP 메서드 목록입니다. |
|
allowedOrigins |
string[] |
CorsRule 요소가 있는 경우 필요합니다. CORS를 통해 허용되는 원본 도메인 목록 또는 모든 도메인을 허용하는 "*" |
exposedHeaders |
string[] |
CorsRule 요소가 있는 경우 필요합니다. CORS 클라이언트에 노출할 응답 헤더 목록입니다. |
maxAgeInSeconds |
integer |
CorsRule 요소가 있는 경우 필요합니다. 클라이언트/브라우저가 실행 전 응답을 캐시해야 하는 시간(초)입니다. |
CorsRules
CORS 규칙을 설정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다.
Name | 형식 | Description |
---|---|---|
corsRules |
Cors |
CORS 규칙 목록입니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. |
DeleteRetentionPolicy
일시 삭제에 대한 서비스 속성입니다.
Name | 형식 | Description |
---|---|---|
allowPermanentDelete |
boolean |
true로 설정된 경우 이 속성을 사용하면 일시 삭제된 Blob 버전 및 스냅샷을 삭제할 수 있습니다. 이 속성은 Blob 복원 정책을 사용할 수 없습니다. 이 속성은 Blob 서비스에만 적용되며 컨테이너 또는 파일 공유에는 적용되지 않습니다. |
days |
integer |
삭제된 항목을 보존해야 하는 일 수를 나타냅니다. 지정한 최소값은 1이고 최대값은 365일 수 있습니다. |
enabled |
boolean |
DeleteRetentionPolicy를 사용할 수 있는지 여부를 나타냅니다. |
LastAccessTimeTrackingPolicy
마지막 액세스 시간 기반 추적 정책에 대한 Blob 서비스 속성입니다.
Name | 형식 | Description |
---|---|---|
blobType |
string[] |
미리 정의된 지원되는 Blob 형식의 배열입니다. blockBlob만 지원되는 값입니다. 이 필드는 현재 읽기 전용입니다. |
enable |
boolean |
true로 설정된 경우 마지막 액세스 시간 기반 추적이 사용하도록 설정됩니다. |
name |
정책의 이름입니다. 유효한 값은 AccessTimeTracking입니다. 이 필드는 현재 읽기 전용입니다. |
|
trackingGranularityInDays |
integer |
필드는 Blob 개체 추적 세분성(일반적으로 Blob 개체를 추적해야 하는 빈도)을 지정합니다. 이 필드는 현재 값이 1인 경우에만 읽습니다. |
name
정책의 이름입니다. 유효한 값은 AccessTimeTracking입니다. 이 필드는 현재 읽기 전용입니다.
Name | 형식 | Description |
---|---|---|
AccessTimeTracking |
string |
RestorePolicyProperties
Blob 복원 정책에 대한 Blob 서비스 속성
Name | 형식 | Description |
---|---|---|
days |
integer |
이 Blob을 복원할 수 있는 기간입니다. 0보다 크고 DeleteRetentionPolicy.days보다 작아야 합니다. |
enabled |
boolean |
true로 설정하면 Blob 복원이 활성화됩니다. |
lastEnabledTime |
string |
minRestoreTime 속성을 위해 사용되지 않습니다. |
minRestoreTime |
string |
복원을 시작할 수 있는 최소 날짜 및 시간을 반환합니다. |
Sku
스토리지 계정의 SKU입니다.
Name | 형식 | Description |
---|---|---|
name |
SKU 이름입니다. 계정을 만드는 데 필요합니다. 업데이트에 대한 선택 사항입니다. 이전 버전에서는 SKU 이름을 accountType이라고 했습니다. |
|
tier |
SKU 계층. 이는 SKU 이름을 기반으로 합니다. |
SkuName
SKU 이름입니다. 계정을 만드는 데 필요합니다. 업데이트에 대한 선택 사항입니다. 이전 버전에서는 SKU 이름을 accountType이라고 했습니다.
Name | 형식 | Description |
---|---|---|
Premium_LRS |
string |
|
Premium_ZRS |
string |
|
Standard_GRS |
string |
|
Standard_GZRS |
string |
|
Standard_LRS |
string |
|
Standard_RAGRS |
string |
|
Standard_RAGZRS |
string |
|
Standard_ZRS |
string |
SkuTier
SKU 계층. 이는 SKU 이름을 기반으로 합니다.
Name | 형식 | Description |
---|---|---|
Premium |
string |
|
Standard |
string |