Dela via


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

string

minLength: 1
maxLength: 90

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

storageTaskName
path True

string

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

subscriptionId
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

ManagedServiceIdentity

Resursens hanterade tjänstidentitet.

location True

string

Den geo-plats där resursen finns

properties.action True

StorageTaskAction

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

StorageTask

Uppdateringsåtgärden för resursen "StorageTask" lyckades

201 Created

StorageTask

Resursen "StorageTask" har skapats

Sidhuvuden

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

Resursåtgärden har godkänts.

Sidhuvuden

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

ErrorResponse

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
createdByType

Den typ av identitet som skapade resursen.

ElseCondition

Det andra blocket för lagringsaktivitetsåtgärd

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

IfCondition

Åtgärden if block of storage task (Om-block för lagringsaktivitet)

ManagedServiceIdentity

Hanterad tjänstidentitet (systemtilldelade och/eller användartilldelade identiteter)

ManagedServiceIdentityType

Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts).

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.

ProvisioningState

Representerar etableringstillståndet för lagringsaktiviteten.

StorageTask

Representerar lagringsaktivitet.

StorageTaskAction

Åtgärden för lagringsaktivitet representerar villkorssatser och åtgärder som ska utföras på målobjekt.

StorageTaskOperation

Representerar en åtgärd som ska utföras på objektet

StorageTaskOperationName

Åtgärden som ska utföras på objektet.

systemData

Metadata som rör skapande och senaste ändring av resursen.

UserAssignedIdentity

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

StorageTaskOperation[]

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

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

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

StorageTaskOperation[]

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

ManagedServiceIdentityType

Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts).

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned identiteter
Uppsättningen användartilldelade identiteter som är associerade med resursen. Ordlistenycklarna userAssignedIdentities är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Ordlistevärdena kan vara tomma objekt ({}) i begäranden.

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

ManagedServiceIdentity

Resursens hanterade tjänstidentitet.

location

string

Den geo-plats där resursen finns

name

string

Namnet på resursen

properties.action

StorageTaskAction

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

ProvisioningState

Representerar etableringstillståndet för lagringsaktiviteten.

properties.taskVersion

integer (int64)

minimum: 1
maximum: 1

Lagringsuppgiftsversion.

systemData

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

ElseCondition

Det andra blocket för lagringsaktivitetsåtgärd

if

IfCondition

Å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

StorageTaskOperationName

Åtgärden som ska utföras på objektet.

onFailure

OnFailure

Åtgärder som ska vidtas när åtgärden misslyckas för ett objekt.

onSuccess

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

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

createdByType

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.