Storage Tasks - Create
Secara asinkron membuat sumber daya tugas penyimpanan baru dengan parameter yang ditentukan. Jika tugas penyimpanan sudah dibuat dan permintaan pembuatan berikutnya dikeluarkan dengan properti yang berbeda, properti tugas penyimpanan akan diperbarui. Jika tugas penyimpanan sudah dibuat dan permintaan buat atau perbarui berikutnya dikeluarkan dengan kumpulan properti yang sama persis, permintaan akan berhasil.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}?api-version=2023-01-01
Parameter URI
| Nama | Dalam | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nama grup sumber daya. Nama ini tidak peka huruf besar/kecil. |
|
storage
|
path | True |
string minLength: 3maxLength: 18 pattern: ^[a-z0-9]{3,18}$ |
Nama tugas penyimpanan dalam grup sumber daya yang ditentukan. Panjang nama tugas penyimpanan harus antara 3 dan 18 karakter dan hanya menggunakan angka dan huruf kecil. |
|
subscription
|
path | True |
string (uuid) |
ID langganan target. Nilainya harus UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versi API yang akan digunakan untuk operasi ini. |
Isi Permintaan
| Nama | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|
| identity | True |
Identitas layanan terkelola sumber daya. |
|
| location | True |
string |
Lokasi geografis tempat sumber daya berada |
| properties.action | True |
Tindakan tugas penyimpanan yang dijalankan |
|
| properties.description | True |
string |
Teks yang menjelaskan tujuan tugas penyimpanan |
| properties.enabled | True |
boolean |
Tugas Penyimpanan diaktifkan ketika diatur ke true dan dinonaktifkan saat diatur ke false |
| tags |
object |
Tag sumber daya. |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
Operasi pembaruan 'StorageTask' sumber daya berhasil |
|
| 201 Created |
Operasi pembuatan 'StorageTask' sumber daya berhasil Header
|
|
| 202 Accepted |
Operasi sumber daya diterima. Header
|
|
| Other Status Codes |
Respons kesalahan tak terduga. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory.
Jenis:
oauth2
Alur:
implicit
URL Otorisasi:
https://login.microsoftonline.com/common/oauth2/authorize
Cakupan
| Nama | Deskripsi |
|---|---|
| user_impersonation | meniru akun pengguna Anda |
Contoh
PutStorageTask
Permintaan sampel
PUT https://management.azure.com/subscriptions/1f31ba14-ce16-4281-b9b4-3e78da6e1616/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1?api-version=2023-01-01
{
"identity": {
"type": "SystemAssigned"
},
"location": "westus",
"properties": {
"description": "My Storage task",
"action": {
"else": {
"operations": [
{
"name": "DeleteBlob",
"onFailure": "break",
"onSuccess": "continue"
}
]
},
"if": {
"condition": "[[equals(AccessTier, 'Cool')]]",
"operations": [
{
"name": "SetBlobTier",
"onFailure": "break",
"onSuccess": "continue",
"parameters": {
"tier": "Hot"
}
}
]
}
},
"enabled": true
}
}
Respon sampel
location: https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9101/providers/Microsoft.StorageActions/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-01-01
{
"name": "mytask1",
"type": "Microsoft.StorageActions/storageTasks",
"id": "/subscriptions/c86a9c18-8373-41fa-92d4-1d7bdc16977b/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1",
"identity": {
"type": "SystemAssigned",
"principalId": "2fd475e8-8923-4597-842f-7ce1adfc6c4a",
"tenantId": "b4a2005c-32c1-434c-bbf0-ff486912fc75"
},
"location": "westus",
"properties": {
"description": "Storage task",
"action": {
"else": {
"operations": [
{
"name": "DeleteBlob",
"onFailure": "break",
"onSuccess": "continue"
}
]
},
"if": {
"condition": "[[equals(AccessTier, 'Cool')]]",
"operations": [
{
"name": "SetBlobTier",
"onFailure": "break",
"onSuccess": "continue",
"parameters": {
"tier": "Hot"
}
}
]
}
},
"creationTimeInUtc": "2023-07-06T00:24:59.1441663Z",
"enabled": true,
"provisioningState": "Succeeded",
"taskVersion": 1
}
}
location: https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9101/providers/Microsoft.StorageActions/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-01-01
{
"name": "mytask1",
"type": "Microsoft.StorageActions/storageTasks",
"id": "/subscriptions/c86a9c18-8373-41fa-92d4-1d7bdc16977b/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1",
"identity": {
"type": "SystemAssigned",
"principalId": "2fd475e8-8923-4597-842f-7ce1adfc6c4a",
"tenantId": "b4a2005c-32c1-434c-bbf0-ff486912fc75"
},
"location": "westus",
"properties": {
"description": "Storage task",
"action": {
"else": {
"operations": [
{
"name": "DeleteBlob",
"onFailure": "break",
"onSuccess": "continue"
}
]
},
"if": {
"condition": "[[equals(AccessTier, 'Cool')]]",
"operations": [
{
"name": "SetBlobTier",
"onFailure": "break",
"onSuccess": "continue",
"parameters": {
"tier": "Hot"
}
}
]
}
},
"creationTimeInUtc": "2023-07-06T00:24:59.1441663Z",
"enabled": true,
"provisioningState": "Succeeded",
"taskVersion": 1
}
}
location: https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9101/providers/Microsoft.StorageActions/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-01-01
Definisi
| Nama | Deskripsi |
|---|---|
|
created |
Jenis identitas yang membuat sumber daya. |
|
Else |
Blok lain dari operasi tugas penyimpanan |
|
Error |
Info tambahan kesalahan manajemen sumber daya. |
|
Error |
Detail kesalahan. |
|
Error |
Tanggapan kesalahan |
|
If |
Blok jika operasi tugas penyimpanan |
|
Managed |
Identitas layanan terkelola (identitas yang ditetapkan sistem dan/atau pengguna) |
|
Managed |
Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan). |
|
On |
Tindakan yang akan diambil ketika operasi gagal untuk objek. |
|
On |
Tindakan yang akan diambil ketika operasi berhasil untuk objek. |
|
Provisioning |
Mewakili status provisi tugas penyimpanan. |
|
Storage |
Mewakili Tugas Penyimpanan. |
|
Storage |
Tindakan tugas penyimpanan mewakili pernyataan kondisional dan operasi yang akan dilakukan pada objek target. |
|
Storage |
Mewakili operasi yang akan dilakukan pada objek |
|
Storage |
Operasi yang akan dilakukan pada objek. |
|
system |
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya. |
|
User |
Properti identitas yang ditetapkan pengguna |
createdByType
Jenis identitas yang membuat sumber daya.
| Nilai | Deskripsi |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ElseCondition
Blok lain dari operasi tugas penyimpanan
| Nama | Jenis | Deskripsi |
|---|---|---|
| operations |
Daftar operasi yang akan dijalankan di blok lain |
ErrorAdditionalInfo
Info tambahan kesalahan manajemen sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| info |
object |
Info tambahan. |
| type |
string |
Jenis info tambahan. |
ErrorDetail
Detail kesalahan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| additionalInfo |
Info tambahan kesalahan. |
|
| code |
string |
Kode kesalahan. |
| details |
Detail kesalahan. |
|
| message |
string |
Pesan kesalahan. |
| target |
string |
Target kesalahan. |
ErrorResponse
Tanggapan kesalahan
| Nama | Jenis | Deskripsi |
|---|---|---|
| error |
Objek kesalahan. |
IfCondition
Blok jika operasi tugas penyimpanan
| Nama | Jenis | Deskripsi |
|---|---|---|
| condition |
string |
Predikat kondisi untuk mengevaluasi setiap objek. Lihat https://aka.ms/storagetaskconditions untuk properti dan operator yang valid. |
| operations |
Daftar operasi yang akan dijalankan ketika kondisi predikat terpenuhi. |
ManagedServiceIdentity
Identitas layanan terkelola (identitas yang ditetapkan sistem dan/atau pengguna)
| Nama | Jenis | Deskripsi |
|---|---|---|
| principalId |
string (uuid) |
ID perwakilan layanan dari identitas yang ditetapkan sistem. Properti ini hanya akan disediakan untuk identitas yang ditetapkan sistem. |
| tenantId |
string (uuid) |
ID penyewa dari identitas yang ditetapkan sistem. Properti ini hanya akan disediakan untuk identitas yang ditetapkan sistem. |
| type |
Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan). |
|
| userAssignedIdentities |
<string,
User |
Identitas User-Assigned |
ManagedServiceIdentityType
Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan).
| Nilai | Deskripsi |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
OnFailure
Tindakan yang akan diambil ketika operasi gagal untuk objek.
| Nilai | Deskripsi |
|---|---|
| break |
OnSuccess
Tindakan yang akan diambil ketika operasi berhasil untuk objek.
| Nilai | Deskripsi |
|---|---|
| continue |
ProvisioningState
Mewakili status provisi tugas penyimpanan.
| Nilai | Deskripsi |
|---|---|
| ValidateSubscriptionQuotaBegin | |
| ValidateSubscriptionQuotaEnd | |
| Accepted | |
| Creating | |
| Succeeded | |
| Deleting | |
| Canceled | |
| Failed |
StorageTask
Mewakili Tugas Penyimpanan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| id |
string (arm-id) |
ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| identity |
Identitas layanan terkelola sumber daya. |
|
| location |
string |
Lokasi geografis tempat sumber daya berada |
| name |
string |
Nama sumber daya |
| properties.action |
Tindakan tugas penyimpanan yang dijalankan |
|
| properties.creationTimeInUtc |
string (date-time) |
Tanggal dan waktu pembuatan tugas penyimpanan di UTC. |
| properties.description |
string |
Teks yang menjelaskan tujuan tugas penyimpanan |
| properties.enabled |
boolean |
Tugas Penyimpanan diaktifkan ketika diatur ke true dan dinonaktifkan saat diatur ke false |
| properties.provisioningState |
Mewakili status provisi tugas penyimpanan. |
|
| properties.taskVersion |
integer (int64) minimum: 1maximum: 1 |
Versi tugas penyimpanan. |
| systemData |
Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy. |
|
| tags |
object |
Tag sumber daya. |
| type |
string |
Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts" |
StorageTaskAction
Tindakan tugas penyimpanan mewakili pernyataan kondisional dan operasi yang akan dilakukan pada objek target.
| Nama | Jenis | Deskripsi |
|---|---|---|
| else |
Blok lain dari operasi tugas penyimpanan |
|
| if |
Blok jika operasi tugas penyimpanan |
StorageTaskOperation
Mewakili operasi yang akan dilakukan pada objek
| Nama | Jenis | Deskripsi |
|---|---|---|
| name |
Operasi yang akan dilakukan pada objek. |
|
| onFailure |
Tindakan yang akan diambil ketika operasi gagal untuk objek. |
|
| onSuccess |
Tindakan yang akan diambil ketika operasi berhasil untuk objek. |
|
| parameters |
object |
Parameter kunci-nilai untuk operasi. |
StorageTaskOperationName
Operasi yang akan dilakukan pada objek.
| Nilai | Deskripsi |
|---|---|
| SetBlobTier | |
| SetBlobTags | |
| SetBlobImmutabilityPolicy | |
| SetBlobLegalHold | |
| SetBlobExpiry | |
| DeleteBlob | |
| UndeleteBlob |
systemData
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| createdAt |
string (date-time) |
Tanda waktu pembuatan sumber daya (UTC). |
| createdBy |
string |
Identitas yang membuat sumber daya. |
| createdByType |
Jenis identitas yang membuat sumber daya. |
|
| lastModifiedAt |
string (date-time) |
Tanda waktu modifikasi terakhir sumber daya (UTC) |
| lastModifiedBy |
string |
Identitas yang terakhir mengubah sumber daya. |
| lastModifiedByType |
Jenis identitas yang terakhir memodifikasi sumber daya. |
UserAssignedIdentity
Properti identitas yang ditetapkan pengguna
| Nama | Jenis | Deskripsi |
|---|---|---|
| clientId |
string (uuid) |
ID klien dari identitas yang ditetapkan. |
| principalId |
string (uuid) |
ID utama identitas yang ditetapkan. |