Freigeben über


Storage Tasks - Create

Erstellt asynchron eine neue Speicheraufgabenressource mit den angegebenen Parametern. Wenn bereits eine Speicheraufgabe erstellt und eine nachfolgende Erstellungsanforderung mit unterschiedlichen Eigenschaften ausgegeben wird, werden die Speicheraufgabeneigenschaften aktualisiert. Wenn bereits eine Speicheraufgabe erstellt und eine nachfolgende Erstellungs- oder Aktualisierungsanforderung mit dem exakten Satz von Eigenschaften ausgegeben wird, wird die Anforderung erfolgreich ausgeführt.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}?api-version=2023-01-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

storageTaskName
path True

string

minLength: 3
maxLength: 18
pattern: ^[a-z0-9]{3,18}$

Der Name des Speichervorgangs innerhalb der angegebenen Ressourcengruppe. Die Namen von Speicheraufgaben müssen zwischen 3 und 18 Zeichen lang sein und nur Zahlen und Kleinbuchstaben verwenden.

subscriptionId
path True

string (uuid)

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name Erforderlich Typ Beschreibung
identity True

ManagedServiceIdentity

Die verwaltete Dienstidentität der Ressource.

location True

string

Der geografische Standort, an dem sich die Ressource befindet

properties.action True

StorageTaskAction

Die ausgeführte Speicheraufgabenaktion

properties.description True

string

Text, der den Zweck der Speicheraufgabe beschreibt

properties.enabled True

boolean

Speicheraufgabe ist aktiviert, wenn sie auf "true" und "deaktiviert" festgelegt ist, wenn sie auf "false" festgelegt ist.

tags

object

Ressourcentags.

Antworten

Name Typ Beschreibung
200 OK

StorageTask

OK - Aktualisieren Sie die Speicheraufgabe mit den gleichen Eigenschaften, die im Anforderungstext angegeben sind.

201 Created

StorageTask

OK - Erstellen Sie eine Speicheraufgabe mit den gleichen Eigenschaften, die im Anforderungstext angegeben sind.

202 Accepted

Angenommen – Anforderung erstellen oder aktualisieren; Der Vorgang wird asynchron abgeschlossen.

Header

Location: string

Other Status Codes

ErrorResponse

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

PutStorageTask

Beispielanforderung

PUT https://management.azure.com/subscriptions/1f31ba14-ce16-4281-b9b4-3e78da6e1616/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1?api-version=2023-01-01

{
  "location": "westus",
  "identity": {
    "type": "SystemAssigned"
  },
  "properties": {
    "enabled": true,
    "description": "My Storage task",
    "action": {
      "if": {
        "condition": "[[equals(AccessTier, 'Cool')]]",
        "operations": [
          {
            "name": "SetBlobTier",
            "parameters": {
              "tier": "Hot"
            },
            "onSuccess": "continue",
            "onFailure": "break"
          }
        ]
      },
      "else": {
        "operations": [
          {
            "name": "DeleteBlob",
            "onSuccess": "continue",
            "onFailure": "break"
          }
        ]
      }
    }
  }
}

Beispiel für eine Antwort

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
{
  "id": "/subscriptions/c86a9c18-8373-41fa-92d4-1d7bdc16977b/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1",
  "name": "mytask1",
  "type": "Microsoft.StorageActions/storageTasks",
  "location": "westus",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "2fd475e8-8923-4597-842f-7ce1adfc6c4a",
    "tenantId": "b4a2005c-32c1-434c-bbf0-ff486912fc75"
  },
  "properties": {
    "enabled": true,
    "description": "Storage task",
    "action": {
      "if": {
        "condition": "[[equals(AccessTier, 'Cool')]]",
        "operations": [
          {
            "name": "SetBlobTier",
            "parameters": {
              "tier": "Hot"
            },
            "onSuccess": "continue",
            "onFailure": "break"
          }
        ]
      },
      "else": {
        "operations": [
          {
            "name": "DeleteBlob",
            "onSuccess": "continue",
            "onFailure": "break"
          }
        ]
      }
    },
    "taskVersion": 1,
    "provisioningState": "Succeeded",
    "creationTimeInUtc": "2023-07-06T00:24:59.1441663Z"
  }
}
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
{
  "id": "/subscriptions/c86a9c18-8373-41fa-92d4-1d7bdc16977b/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1",
  "name": "mytask1",
  "type": "Microsoft.StorageActions/storageTasks",
  "location": "westus",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "2fd475e8-8923-4597-842f-7ce1adfc6c4a",
    "tenantId": "b4a2005c-32c1-434c-bbf0-ff486912fc75"
  },
  "properties": {
    "enabled": true,
    "description": "Storage task",
    "action": {
      "if": {
        "condition": "[[equals(AccessTier, 'Cool')]]",
        "operations": [
          {
            "name": "SetBlobTier",
            "parameters": {
              "tier": "Hot"
            },
            "onSuccess": "continue",
            "onFailure": "break"
          }
        ]
      },
      "else": {
        "operations": [
          {
            "name": "DeleteBlob",
            "onSuccess": "continue",
            "onFailure": "break"
          }
        ]
      }
    },
    "taskVersion": 1,
    "provisioningState": "Succeeded",
    "creationTimeInUtc": "2023-07-06T00:24:59.1441663Z"
  }
}
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

Definitionen

Name Beschreibung
createdByType

Der Identitätstyp, der die Ressource erstellt hat.

ElseCondition

Der andere Block des Speicheraufgabenvorgangs

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

IfCondition

Der If-Block des Speicheraufgabenvorgangs

ManagedServiceIdentity

Verwaltete Dienstidentität (vom System zugewiesene und/oder vom Benutzer zugewiesene Identitäten)

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).

onFailure

Aktion, die ausgeführt werden soll, wenn der Vorgang für ein Objekt fehlschlägt.

onSuccess

Aktion, die ausgeführt werden soll, wenn der Vorgang für ein Objekt erfolgreich ist.

ProvisioningState

Stellt den Bereitstellungsstatus der Speicheraufgabe dar.

StorageTask

Stellt "Speicheraufgabe" dar.

StorageTaskAction

Die Speicheraufgabenaktion stellt bedingte Anweisungen und Vorgänge dar, die für Zielobjekte ausgeführt werden sollen.

StorageTaskOperation

Stellt einen Vorgang dar, der für das Objekt ausgeführt werden soll.

StorageTaskOperationName

Der vorgang, der für das Objekt ausgeführt werden soll.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

UserAssignedIdentity

Benutzer zugewiesene Identitätseigenschaften

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Wert Beschreibung
Application
Key
ManagedIdentity
User

ElseCondition

Der andere Block des Speicheraufgabenvorgangs

Name Typ Beschreibung
operations

StorageTaskOperation[]

Liste der Vorgänge, die im else-Block ausgeführt werden sollen

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

IfCondition

Der If-Block des Speicheraufgabenvorgangs

Name Typ Beschreibung
condition

string

Bedingungs-Prädikat, um jedes Objekt auszuwerten. Unter https://aka.ms/storagetaskconditions finden Sie gültige Eigenschaften und Operatoren.

operations

StorageTaskOperation[]

Liste der Auszuführenden Vorgänge, wenn das Bedingungsdrädikat erfüllt ist.

ManagedServiceIdentity

Verwaltete Dienstidentität (vom System zugewiesene und/oder vom Benutzer zugewiesene Identitäten)

Name Typ Beschreibung
principalId

string (uuid)

Die Dienstprinzipal-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.

tenantId

string (uuid)

Die Mandanten-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.

type

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned Identitäten
Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein.

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).

Wert Beschreibung
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

onFailure

Aktion, die ausgeführt werden soll, wenn der Vorgang für ein Objekt fehlschlägt.

Wert Beschreibung
break

onSuccess

Aktion, die ausgeführt werden soll, wenn der Vorgang für ein Objekt erfolgreich ist.

Wert Beschreibung
continue

ProvisioningState

Stellt den Bereitstellungsstatus der Speicheraufgabe dar.

Wert Beschreibung
Accepted
Canceled
Creating
Deleting
Failed
Succeeded
ValidateSubscriptionQuotaBegin
ValidateSubscriptionQuotaEnd

StorageTask

Stellt "Speicheraufgabe" dar.

Name Typ Beschreibung
id

string (arm-id)

Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

ManagedServiceIdentity

Die verwaltete Dienstidentität der Ressource.

location

string

Der geografische Standort, an dem sich die Ressource befindet

name

string

Der Name der Ressource

properties.action

StorageTaskAction

Die ausgeführte Speicheraufgabenaktion

properties.creationTimeInUtc

string (date-time)

Das Erstellungsdatum und die Uhrzeit des Speichervorgangs in UTC.

properties.description

string

Text, der den Zweck der Speicheraufgabe beschreibt

properties.enabled

boolean

Speicheraufgabe ist aktiviert, wenn sie auf "true" und "deaktiviert" festgelegt ist, wenn sie auf "false" festgelegt ist.

properties.provisioningState

ProvisioningState

Stellt den Bereitstellungsstatus der Speicheraufgabe dar.

properties.taskVersion

integer (int64)

minimum: 1
maximum: 1

Speicheraufgabenversion.

systemData

systemData

Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.

tags

object

Ressourcentags.

type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

StorageTaskAction

Die Speicheraufgabenaktion stellt bedingte Anweisungen und Vorgänge dar, die für Zielobjekte ausgeführt werden sollen.

Name Typ Beschreibung
else

ElseCondition

Der andere Block des Speicheraufgabenvorgangs

if

IfCondition

Der If-Block des Speicheraufgabenvorgangs

StorageTaskOperation

Stellt einen Vorgang dar, der für das Objekt ausgeführt werden soll.

Name Typ Beschreibung
name

StorageTaskOperationName

Der vorgang, der für das Objekt ausgeführt werden soll.

onFailure

onFailure

Aktion, die ausgeführt werden soll, wenn der Vorgang für ein Objekt fehlschlägt.

onSuccess

onSuccess

Aktion, die ausgeführt werden soll, wenn der Vorgang für ein Objekt erfolgreich ist.

parameters

object

Schlüsselwertparameter für den Vorgang.

StorageTaskOperationName

Der vorgang, der für das Objekt ausgeführt werden soll.

Wert Beschreibung
DeleteBlob
SetBlobExpiry
SetBlobImmutabilityPolicy
SetBlobLegalHold
SetBlobTags
SetBlobTier
UndeleteBlob

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name Typ Beschreibung
createdAt

string (date-time)

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string (date-time)

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.

UserAssignedIdentity

Benutzer zugewiesene Identitätseigenschaften

Name Typ Beschreibung
clientId

string (uuid)

Die Client-ID der zugewiesenen Identität.

principalId

string (uuid)

Die Prinzipal-ID der zugewiesenen Identität.