Bagikan melalui


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
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nama grup sumber daya. Nama ini tidak peka huruf besar/kecil.

storageTaskName
path True

string

minLength: 3
maxLength: 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.

subscriptionId
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

ManagedServiceIdentity

Identitas layanan terkelola sumber daya.

location True

string

Lokasi geografis tempat sumber daya berada

properties.action True

StorageTaskAction

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

StorageTask

Operasi pembaruan 'StorageTask' sumber daya berhasil

201 Created

StorageTask

Operasi pembuatan 'StorageTask' sumber daya berhasil

Header

  • Location: string
  • Retry-After: integer
202 Accepted

Operasi sumber daya diterima.

Header

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

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
createdByType

Jenis identitas yang membuat sumber daya.

ElseCondition

Blok lain dari operasi tugas penyimpanan

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Tanggapan kesalahan

IfCondition

Blok jika operasi tugas penyimpanan

ManagedServiceIdentity

Identitas layanan terkelola (identitas yang ditetapkan sistem dan/atau pengguna)

ManagedServiceIdentityType

Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan).

OnFailure

Tindakan yang akan diambil ketika operasi gagal untuk objek.

OnSuccess

Tindakan yang akan diambil ketika operasi berhasil untuk objek.

ProvisioningState

Mewakili status provisi tugas penyimpanan.

StorageTask

Mewakili Tugas Penyimpanan.

StorageTaskAction

Tindakan tugas penyimpanan mewakili pernyataan kondisional dan operasi yang akan dilakukan pada objek target.

StorageTaskOperation

Mewakili operasi yang akan dilakukan pada objek

StorageTaskOperationName

Operasi yang akan dilakukan pada objek.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

UserAssignedIdentity

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

StorageTaskOperation[]

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

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Detail kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponse

Tanggapan kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

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

StorageTaskOperation[]

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

ManagedServiceIdentityType

Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan).

userAssignedIdentities

<string,  UserAssignedIdentity>

Identitas User-Assigned
Kumpulan identitas yang ditetapkan pengguna yang terkait dengan sumber daya. Kunci kamus userAssignedIdentities akan menjadi id sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Nilai kamus dapat berupa objek kosong ({}) dalam permintaan.

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

ManagedServiceIdentity

Identitas layanan terkelola sumber daya.

location

string

Lokasi geografis tempat sumber daya berada

name

string

Nama sumber daya

properties.action

StorageTaskAction

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

ProvisioningState

Mewakili status provisi tugas penyimpanan.

properties.taskVersion

integer (int64)

minimum: 1
maximum: 1

Versi tugas penyimpanan.

systemData

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

ElseCondition

Blok lain dari operasi tugas penyimpanan

if

IfCondition

Blok jika operasi tugas penyimpanan

StorageTaskOperation

Mewakili operasi yang akan dilakukan pada objek

Nama Jenis Deskripsi
name

StorageTaskOperationName

Operasi yang akan dilakukan pada objek.

onFailure

OnFailure

Tindakan yang akan diambil ketika operasi gagal untuk objek.

onSuccess

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

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

createdByType

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.