Condividi tramite


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

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.

storageTaskName
path True

string

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

subscriptionId
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

ManagedServiceIdentity

Identità del servizio gestito della risorsa.

location True

string

Posizione geografica in cui risiede la risorsa

properties.action True

StorageTaskAction

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

StorageTask

L'operazione di aggiornamento della risorsa 'StorageTask' è riuscita

201 Created

StorageTask

Operazione di creazione della risorsa 'StorageTask' riuscita

Intestazioni

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

Operazione di risorsa accettata.

Intestazioni

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

ErrorResponse

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
createdByType

Tipo di identità che ha creato la risorsa.

ElseCondition

Blocco di attività di archiviazione diverso

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

IfCondition

Oggetto if dell'operazione dell'attività di archiviazione

ManagedServiceIdentity

Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)

ManagedServiceIdentityType

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

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 .

ProvisioningState

Rappresenta lo stato di provisioning dell'attività di archiviazione.

StorageTask

Rappresenta l'attività di archiviazione.

StorageTaskAction

L'azione dell'attività di archiviazione rappresenta istruzioni condizionali e operazioni da eseguire sugli oggetti di destinazione.

StorageTaskOperation

Rappresenta un'operazione da eseguire sull'oggetto

StorageTaskOperationName

Operazione da eseguire sull'oggetto .

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

UserAssignedIdentity

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

StorageTaskOperation[]

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

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

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

StorageTaskOperation[]

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

ManagedServiceIdentityType

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

userAssignedIdentities

<string,  UserAssignedIdentity>

identità User-Assigned
Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

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

ManagedServiceIdentity

Identità del servizio gestito della risorsa.

location

string

Posizione geografica in cui risiede la risorsa

name

string

Nome della risorsa

properties.action

StorageTaskAction

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

ProvisioningState

Rappresenta lo stato di provisioning dell'attività di archiviazione.

properties.taskVersion

integer (int64)

minimum: 1
maximum: 1

Versione dell'attività di archiviazione.

systemData

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

ElseCondition

Blocco di attività di archiviazione diverso

if

IfCondition

Oggetto if dell'operazione dell'attività di archiviazione

StorageTaskOperation

Rappresenta un'operazione da eseguire sull'oggetto

Nome Tipo Descrizione
name

StorageTaskOperationName

Operazione da eseguire sull'oggetto .

onFailure

OnFailure

Azione da eseguire quando l'operazione non riesce per un oggetto .

onSuccess

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

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

createdByType

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.