Storage Tasks - Create
Crea in modo asincrono una nuova risorsa di attività di archiviazione con i parametri specificati. Se è già stata creata un'attività di archiviazione e viene eseguita una richiesta di creazione successiva con proprietà diverse, le proprietà dell'attività di archiviazione verranno aggiornate. Se un'attività di archiviazione è già stata creata e viene eseguita una richiesta di creazione o aggiornamento successiva con lo stesso set esatto di proprietà, la richiesta avrà esito positivo.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}?api-version=2023-01-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole. |
|
storage
|
path | True |
string minLength: 3maxLength: 18 pattern: ^[a-z0-9]{3,18}$ |
Nome dell'attività di archiviazione all'interno del gruppo di risorse specificato. I nomi delle attività di archiviazione devono avere una lunghezza compresa tra 3 e 18 caratteri e usare solo numeri e lettere minuscole. |
|
subscription
|
path | True |
string (uuid) |
ID della sottoscrizione di destinazione. Il valore deve essere un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| identity | True |
Identità del servizio gestito della risorsa. |
|
| location | True |
string |
Posizione geografica in cui risiede la risorsa |
| properties.action | True |
Azione dell'attività di archiviazione eseguita |
|
| properties.description | True |
string |
Testo che descrive lo scopo dell'attività di archiviazione |
| properties.enabled | True |
boolean |
L'attività di archiviazione è abilitata quando è impostata su true e disabilitata quando è impostata su false |
| tags |
object |
Tag di risorsa. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
L'operazione di aggiornamento della risorsa 'StorageTask' è riuscita |
|
| 201 Created |
Operazione di creazione della risorsa 'StorageTask' riuscita Intestazioni
|
|
| 202 Accepted |
Operazione di risorsa accettata. Intestazioni
|
|
| Other Status Codes |
Risposta di errore imprevista. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | rappresentare l'account utente |
Esempio
PutStorageTask
Esempio di richiesta
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
}
}
Risposta di esempio
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
Definizioni
| Nome | Descrizione |
|---|---|
|
created |
Tipo di identità che ha creato la risorsa. |
|
Else |
Blocco di attività di archiviazione diverso |
|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
|
Error |
Dettagli dell'errore. |
|
Error |
Risposta di errore |
|
If |
Oggetto if dell'operazione dell'attività di archiviazione |
|
Managed |
Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente) |
|
Managed |
Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). |
|
On |
Azione da eseguire quando l'operazione non riesce per un oggetto . |
|
On |
Azione da eseguire quando l'operazione ha esito positivo per un oggetto . |
|
Provisioning |
Rappresenta lo stato di provisioning dell'attività di archiviazione. |
|
Storage |
Rappresenta l'attività di archiviazione. |
|
Storage |
L'azione dell'attività di archiviazione rappresenta istruzioni condizionali e operazioni da eseguire sugli oggetti di destinazione. |
|
Storage |
Rappresenta un'operazione da eseguire sull'oggetto |
|
Storage |
Operazione da eseguire sull'oggetto . |
|
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
|
User |
Proprietà di identità assegnate dall'utente |
createdByType
Tipo di identità che ha creato la risorsa.
| Valore | Descrizione |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ElseCondition
Blocco di attività di archiviazione diverso
| Nome | Tipo | Descrizione |
|---|---|---|
| operations |
Elenco di operazioni da eseguire nel blocco else |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
| Nome | Tipo | Descrizione |
|---|---|---|
| info |
object |
Informazioni aggiuntive. |
| type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
| Nome | Tipo | Descrizione |
|---|---|---|
| additionalInfo |
Informazioni aggiuntive sull'errore. |
|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore. |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Oggetto error. |
IfCondition
Oggetto if dell'operazione dell'attività di archiviazione
| Nome | Tipo | Descrizione |
|---|---|---|
| condition |
string |
Predicato della condizione per valutare ogni oggetto. Vedere https://aka.ms/storagetaskconditions per le proprietà e gli operatori validi. |
| operations |
Elenco di operazioni da eseguire quando il predicato della condizione soddisfa. |
ManagedServiceIdentity
Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)
| Nome | Tipo | Descrizione |
|---|---|---|
| principalId |
string (uuid) |
ID entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema. |
| tenantId |
string (uuid) |
ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema. |
| type |
Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). |
|
| userAssignedIdentities |
<string,
User |
identità User-Assigned |
ManagedServiceIdentityType
Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
| Valore | Descrizione |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
OnFailure
Azione da eseguire quando l'operazione non riesce per un oggetto .
| Valore | Descrizione |
|---|---|
| break |
OnSuccess
Azione da eseguire quando l'operazione ha esito positivo per un oggetto .
| Valore | Descrizione |
|---|---|
| continue |
ProvisioningState
Rappresenta lo stato di provisioning dell'attività di archiviazione.
| Valore | Descrizione |
|---|---|
| ValidateSubscriptionQuotaBegin | |
| ValidateSubscriptionQuotaEnd | |
| Accepted | |
| Creating | |
| Succeeded | |
| Deleting | |
| Canceled | |
| Failed |
StorageTask
Rappresenta l'attività di archiviazione.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string (arm-id) |
ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| identity |
Identità del servizio gestito della risorsa. |
|
| location |
string |
Posizione geografica in cui risiede la risorsa |
| name |
string |
Nome della risorsa |
| properties.action |
Azione dell'attività di archiviazione eseguita |
|
| properties.creationTimeInUtc |
string (date-time) |
Data e ora di creazione dell'attività di archiviazione in formato UTC. |
| properties.description |
string |
Testo che descrive lo scopo dell'attività di archiviazione |
| properties.enabled |
boolean |
L'attività di archiviazione è abilitata quando è impostata su true e disabilitata quando è impostata su false |
| properties.provisioningState |
Rappresenta lo stato di provisioning dell'attività di archiviazione. |
|
| properties.taskVersion |
integer (int64) minimum: 1maximum: 1 |
Versione dell'attività di archiviazione. |
| systemData |
Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy. |
|
| tags |
object |
Tag di risorsa. |
| type |
string |
Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
StorageTaskAction
L'azione dell'attività di archiviazione rappresenta istruzioni condizionali e operazioni da eseguire sugli oggetti di destinazione.
| Nome | Tipo | Descrizione |
|---|---|---|
| else |
Blocco di attività di archiviazione diverso |
|
| if |
Oggetto if dell'operazione dell'attività di archiviazione |
StorageTaskOperation
Rappresenta un'operazione da eseguire sull'oggetto
| Nome | Tipo | Descrizione |
|---|---|---|
| name |
Operazione da eseguire sull'oggetto . |
|
| onFailure |
Azione da eseguire quando l'operazione non riesce per un oggetto . |
|
| onSuccess |
Azione da eseguire quando l'operazione ha esito positivo per un oggetto . |
|
| parameters |
object |
Parametri chiave-valore per l'operazione. |
StorageTaskOperationName
Operazione da eseguire sull'oggetto .
| Valore | Descrizione |
|---|---|
| SetBlobTier | |
| SetBlobTags | |
| SetBlobImmutabilityPolicy | |
| SetBlobLegalHold | |
| SetBlobExpiry | |
| DeleteBlob | |
| UndeleteBlob |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
| Nome | Tipo | Descrizione |
|---|---|---|
| createdAt |
string (date-time) |
Timestamp della creazione della risorsa (UTC). |
| createdBy |
string |
Identità che ha creato la risorsa. |
| createdByType |
Tipo di identità che ha creato la risorsa. |
|
| lastModifiedAt |
string (date-time) |
Timestamp dell'ultima modifica della risorsa (UTC) |
| lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
| lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |
UserAssignedIdentity
Proprietà di identità assegnate dall'utente
| Nome | Tipo | Descrizione |
|---|---|---|
| clientId |
string (uuid) |
ID client dell'identità assegnata. |
| principalId |
string (uuid) |
ID entità dell'identità assegnata. |