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 |
---|---|---|---|---|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
storage
|
path | True |
string minLength: 3maxLength: 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. |
subscription
|
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 |
Die verwaltete Dienstidentität der Ressource. |
|
location | True |
string |
Der geografische Standort, an dem sich die Ressource befindet |
properties.action | True |
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 |
OK - Aktualisieren Sie die Speicheraufgabe mit den gleichen Eigenschaften, die im Anforderungstext angegeben sind. |
|
201 Created |
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 |
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 |
---|---|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Else |
Der andere Block des Speicheraufgabenvorgangs |
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
Error |
Das Fehlerdetails. |
Error |
Fehlerantwort |
If |
Der If-Block des Speicheraufgabenvorgangs |
Managed |
Verwaltete Dienstidentität (vom System zugewiesene und/oder vom Benutzer zugewiesene Identitäten) |
Managed |
Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). |
on |
Aktion, die ausgeführt werden soll, wenn der Vorgang für ein Objekt fehlschlägt. |
on |
Aktion, die ausgeführt werden soll, wenn der Vorgang für ein Objekt erfolgreich ist. |
Provisioning |
Stellt den Bereitstellungsstatus der Speicheraufgabe dar. |
Storage |
Stellt "Speicheraufgabe" dar. |
Storage |
Die Speicheraufgabenaktion stellt bedingte Anweisungen und Vorgänge dar, die für Zielobjekte ausgeführt werden sollen. |
Storage |
Stellt einen Vorgang dar, der für das Objekt ausgeführt werden soll. |
Storage |
Der vorgang, der für das Objekt ausgeführt werden soll. |
system |
Metadaten zur Erstellung und letzten Änderung der Ressource. |
User |
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 |
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 |
Die zusätzlichen Informationen des Fehlers. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
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 |
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 |
Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). |
|
userAssignedIdentities |
<string,
User |
User-Assigned Identitäten |
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 |
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 |
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 |
Stellt den Bereitstellungsstatus der Speicheraufgabe dar. |
|
properties.taskVersion |
integer (int64) minimum: 1maximum: 1 |
Speicheraufgabenversion. |
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 |
Der andere Block des Speicheraufgabenvorgangs |
|
if |
Der If-Block des Speicheraufgabenvorgangs |
StorageTaskOperation
Stellt einen Vorgang dar, der für das Objekt ausgeführt werden soll.
Name | Typ | Beschreibung |
---|---|---|
name |
Der vorgang, der für das Objekt ausgeführt werden soll. |
|
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. |
|
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 |
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 |
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. |