Storage Tasks - Create
Asynkront skapar en ny lagringsaktivitetsresurs med de angivna parametrarna. Om en lagringsaktivitet redan har skapats och en efterföljande begäran om att skapa utfärdas med olika egenskaper uppdateras egenskaperna för lagringsaktiviteten. Om en lagringsuppgift redan har skapats och en efterföljande begäran om att skapa eller uppdatera utfärdas med exakt samma uppsättning egenskaper, kommer begäran att lyckas.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}?api-version=2023-01-01
URI-parametrar
| Name | I | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
|
storage
|
path | True |
string minLength: 3maxLength: 18 pattern: ^[a-z0-9]{3,18}$ |
Namnet på lagringsaktiviteten i den angivna resursgruppen. Lagringsaktivitetsnamn måste vara mellan 3 och 18 tecken långa och endast använda siffror och gemener. |
|
subscription
|
path | True |
string (uuid) |
ID för målprenumerationen. Värdet måste vara ett UUID. |
|
api-version
|
query | True |
string minLength: 1 |
DEN API-version som ska användas för den här åtgärden. |
Begärandetext
| Name | Obligatorisk | Typ | Description |
|---|---|---|---|
| identity | True |
Resursens hanterade tjänstidentitet. |
|
| location | True |
string |
Den geo-plats där resursen finns |
| properties.action | True |
Lagringsaktivitetsåtgärden som körs |
|
| properties.description | True |
string |
Text som beskriver syftet med lagringsuppgiften |
| properties.enabled | True |
boolean |
Lagringsaktivitet aktiveras när värdet är sant och inaktiverat när värdet är falskt |
| tags |
object |
Resurstaggar. |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Uppdateringsåtgärden för resursen "StorageTask" lyckades |
|
| 201 Created |
Resursen "StorageTask" har skapats Sidhuvuden
|
|
| 202 Accepted |
Resursåtgärden har godkänts. Sidhuvuden
|
|
| Other Status Codes |
Ett oväntat felsvar. |
Säkerhet
azure_auth
Azure Active Directory OAuth2-flöde.
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
| Name | Description |
|---|---|
| user_impersonation | personifiera ditt användarkonto |
Exempel
PutStorageTask
Exempelbegäran
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
}
}
Exempelsvar
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
Definitioner
| Name | Description |
|---|---|
|
created |
Den typ av identitet som skapade resursen. |
|
Else |
Det andra blocket för lagringsaktivitetsåtgärd |
|
Error |
Ytterligare information om resurshanteringsfelet. |
|
Error |
Felinformationen. |
|
Error |
Felsvar |
|
If |
Åtgärden if block of storage task (Om-block för lagringsaktivitet) |
|
Managed |
Hanterad tjänstidentitet (systemtilldelade och/eller användartilldelade identiteter) |
|
Managed |
Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts). |
|
On |
Åtgärder som ska vidtas när åtgärden misslyckas för ett objekt. |
|
On |
Åtgärder som ska vidtas när åtgärden lyckas för ett objekt. |
|
Provisioning |
Representerar etableringstillståndet för lagringsaktiviteten. |
|
Storage |
Representerar lagringsaktivitet. |
|
Storage |
Åtgärden för lagringsaktivitet representerar villkorssatser och åtgärder som ska utföras på målobjekt. |
|
Storage |
Representerar en åtgärd som ska utföras på objektet |
|
Storage |
Åtgärden som ska utföras på objektet. |
|
system |
Metadata som rör skapande och senaste ändring av resursen. |
|
User |
Användartilldelade identitetsegenskaper |
createdByType
Den typ av identitet som skapade resursen.
| Värde | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ElseCondition
Det andra blocket för lagringsaktivitetsåtgärd
| Name | Typ | Description |
|---|---|---|
| operations |
Lista över åtgärder som ska köras i det andra blocket |
ErrorAdditionalInfo
Ytterligare information om resurshanteringsfelet.
| Name | Typ | Description |
|---|---|---|
| info |
object |
Ytterligare information. |
| type |
string |
Ytterligare informationstyp. |
ErrorDetail
Felinformationen.
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
Ytterligare information om felet. |
|
| code |
string |
Felkoden. |
| details |
Felinformationen. |
|
| message |
string |
Felmeddelandet. |
| target |
string |
Felmålet. |
ErrorResponse
Felsvar
| Name | Typ | Description |
|---|---|---|
| error |
Felobjektet. |
IfCondition
Åtgärden if block of storage task (Om-block för lagringsaktivitet)
| Name | Typ | Description |
|---|---|---|
| condition |
string |
Villkorspredikat för att utvärdera varje objekt. Se https://aka.ms/storagetaskconditions för giltiga egenskaper och operatorer. |
| operations |
Lista över åtgärder som ska köras när villkoret predikatet uppfylls. |
ManagedServiceIdentity
Hanterad tjänstidentitet (systemtilldelade och/eller användartilldelade identiteter)
| Name | Typ | Description |
|---|---|---|
| principalId |
string (uuid) |
Tjänstens huvudnamns-ID för den systemtilldelade identiteten. Den här egenskapen tillhandahålls endast för en systemtilldelad identitet. |
| tenantId |
string (uuid) |
Klientorganisations-ID för den systemtilldelade identiteten. Den här egenskapen tillhandahålls endast för en systemtilldelad identitet. |
| type |
Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts). |
|
| userAssignedIdentities |
<string,
User |
User-Assigned identiteter |
ManagedServiceIdentityType
Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts).
| Värde | Description |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
OnFailure
Åtgärder som ska vidtas när åtgärden misslyckas för ett objekt.
| Värde | Description |
|---|---|
| break |
OnSuccess
Åtgärder som ska vidtas när åtgärden lyckas för ett objekt.
| Värde | Description |
|---|---|
| continue |
ProvisioningState
Representerar etableringstillståndet för lagringsaktiviteten.
| Värde | Description |
|---|---|
| ValidateSubscriptionQuotaBegin | |
| ValidateSubscriptionQuotaEnd | |
| Accepted | |
| Creating | |
| Succeeded | |
| Deleting | |
| Canceled | |
| Failed |
StorageTask
Representerar lagringsaktivitet.
| Name | Typ | Description |
|---|---|---|
| id |
string (arm-id) |
Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| identity |
Resursens hanterade tjänstidentitet. |
|
| location |
string |
Den geo-plats där resursen finns |
| name |
string |
Namnet på resursen |
| properties.action |
Lagringsaktivitetsåtgärden som körs |
|
| properties.creationTimeInUtc |
string (date-time) |
Skapandedatum och tid för lagringsaktiviteten i UTC. |
| properties.description |
string |
Text som beskriver syftet med lagringsuppgiften |
| properties.enabled |
boolean |
Lagringsaktivitet aktiveras när värdet är sant och inaktiverat när värdet är falskt |
| properties.provisioningState |
Representerar etableringstillståndet för lagringsaktiviteten. |
|
| properties.taskVersion |
integer (int64) minimum: 1maximum: 1 |
Lagringsuppgiftsversion. |
| systemData |
Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information. |
|
| tags |
object |
Resurstaggar. |
| type |
string |
Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts" |
StorageTaskAction
Åtgärden för lagringsaktivitet representerar villkorssatser och åtgärder som ska utföras på målobjekt.
| Name | Typ | Description |
|---|---|---|
| else |
Det andra blocket för lagringsaktivitetsåtgärd |
|
| if |
Åtgärden if block of storage task (Om-block för lagringsaktivitet) |
StorageTaskOperation
Representerar en åtgärd som ska utföras på objektet
| Name | Typ | Description |
|---|---|---|
| name |
Åtgärden som ska utföras på objektet. |
|
| onFailure |
Åtgärder som ska vidtas när åtgärden misslyckas för ett objekt. |
|
| onSuccess |
Åtgärder som ska vidtas när åtgärden lyckas för ett objekt. |
|
| parameters |
object |
Nyckel/värde-parametrar för åtgärden. |
StorageTaskOperationName
Åtgärden som ska utföras på objektet.
| Värde | Description |
|---|---|
| SetBlobTier | |
| SetBlobTags | |
| SetBlobImmutabilityPolicy | |
| SetBlobLegalHold | |
| SetBlobExpiry | |
| DeleteBlob | |
| UndeleteBlob |
systemData
Metadata som rör skapande och senaste ändring av resursen.
| Name | Typ | Description |
|---|---|---|
| createdAt |
string (date-time) |
Tidsstämpeln för resursskapande (UTC). |
| createdBy |
string |
Identiteten som skapade resursen. |
| createdByType |
Den typ av identitet som skapade resursen. |
|
| lastModifiedAt |
string (date-time) |
Tidsstämpeln för resursens senaste ändring (UTC) |
| lastModifiedBy |
string |
Identiteten som senast ändrade resursen. |
| lastModifiedByType |
Den typ av identitet som senast ändrade resursen. |
UserAssignedIdentity
Användartilldelade identitetsegenskaper
| Name | Typ | Description |
|---|---|---|
| clientId |
string (uuid) |
Klient-ID för den tilldelade identiteten. |
| principalId |
string (uuid) |
Huvud-ID för den tilldelade identiteten. |