Delen via


Storage Tasks - Create

Asynchroon maakt u een nieuwe opslagtaakresource met de opgegeven parameters. Als er al een opslagtaak is gemaakt en er een volgende aanvraag voor maken wordt uitgegeven met verschillende eigenschappen, worden de eigenschappen van de opslagtaak bijgewerkt. Als er al een opslagtaak is gemaakt en er een volgende aanvraag voor maken of bijwerken wordt uitgegeven met exact dezelfde set eigenschappen, slaagt de aanvraag.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}?api-version=2023-01-01

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

storageTaskName
path True

string

minLength: 3
maxLength: 18
pattern: ^[a-z0-9]{3,18}$

De naam van de opslagtaak binnen de opgegeven resourcegroep. Namen van opslagtaken mogen tussen 3 en 18 tekens lang zijn en mogen alleen cijfers en kleine letters gebruiken.

subscriptionId
path True

string (uuid)

De id van het doelabonnement. De waarde moet een UUID zijn.

api-version
query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Vereist Type Description
identity True

ManagedServiceIdentity

De beheerde service-identiteit van de resource.

location True

string

De geografische locatie waar de resource zich bevindt

properties.action True

StorageTaskAction

De actie opslagtaak die wordt uitgevoerd

properties.description True

string

Tekst waarin het doel van de opslagtaak wordt beschreven

properties.enabled True

boolean

Opslagtaak is ingeschakeld wanneer deze is ingesteld op waar en uitgeschakeld wanneer deze is ingesteld op onwaar

tags

object

Resourcetags.

Antwoorden

Name Type Description
200 OK

StorageTask

De updatebewerking van de resource 'StorageTask' is geslaagd

201 Created

StorageTask

Resource 'StorageTask' bewerking maken geslaagd

Kopteksten

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

Resourcebewerking geaccepteerd.

Kopteksten

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

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

PutStorageTask

Voorbeeldaanvraag

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
  }
}

Voorbeeldrespons

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

Definities

Name Description
createdByType

Het type identiteit waarmee de resource is gemaakt.

ElseCondition

Het restblok van de opslagtaakbewerking

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

IfCondition

Het if-blok van de opslagtaakbewerking

ManagedServiceIdentity

Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten)

ManagedServiceIdentityType

Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).

OnFailure

Er moet actie worden ondernomen wanneer de bewerking voor een object mislukt.

OnSuccess

Er moet actie worden ondernomen wanneer de bewerking voor een object is geslaagd.

ProvisioningState

Vertegenwoordigt de inrichtingsstatus van de opslagtaak.

StorageTask

Vertegenwoordigt opslagtaak.

StorageTaskAction

De actie opslagtaak vertegenwoordigt voorwaardelijke instructies en bewerkingen die moeten worden uitgevoerd op doelobjecten.

StorageTaskOperation

Vertegenwoordigt een bewerking die moet worden uitgevoerd op het object

StorageTaskOperationName

De bewerking die moet worden uitgevoerd op het object.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

UserAssignedIdentity

Door de gebruiker toegewezen identiteitseigenschappen

createdByType

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
User
Application
ManagedIdentity
Key

ElseCondition

Het restblok van de opslagtaakbewerking

Name Type Description
operations

StorageTaskOperation[]

Lijst met bewerkingen die moeten worden uitgevoerd in het else-blok

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

IfCondition

Het if-blok van de opslagtaakbewerking

Name Type Description
condition

string

Voorwaardepredicaat om elk object te evalueren. Zie https://aka.ms/storagetaskconditions voor geldige eigenschappen en operators.

operations

StorageTaskOperation[]

Lijst met bewerkingen die moeten worden uitgevoerd wanneer het predicaat van de voorwaarde voldoet.

ManagedServiceIdentity

Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten)

Name Type Description
principalId

string (uuid)

De service-principal-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.

tenantId

string (uuid)

De tenant-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.

type

ManagedServiceIdentityType

Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned identiteiten
De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen.

ManagedServiceIdentityType

Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).

Waarde Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

OnFailure

Er moet actie worden ondernomen wanneer de bewerking voor een object mislukt.

Waarde Description
break

OnSuccess

Er moet actie worden ondernomen wanneer de bewerking voor een object is geslaagd.

Waarde Description
continue

ProvisioningState

Vertegenwoordigt de inrichtingsstatus van de opslagtaak.

Waarde Description
ValidateSubscriptionQuotaBegin
ValidateSubscriptionQuotaEnd
Accepted
Creating
Succeeded
Deleting
Canceled
Failed

StorageTask

Vertegenwoordigt opslagtaak.

Name Type Description
id

string (arm-id)

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"

identity

ManagedServiceIdentity

De beheerde service-identiteit van de resource.

location

string

De geografische locatie waar de resource zich bevindt

name

string

De naam van de resource

properties.action

StorageTaskAction

De actie opslagtaak die wordt uitgevoerd

properties.creationTimeInUtc

string (date-time)

De aanmaakdatum en -tijd van de opslagtaak in UTC.

properties.description

string

Tekst waarin het doel van de opslagtaak wordt beschreven

properties.enabled

boolean

Opslagtaak is ingeschakeld wanneer deze is ingesteld op waar en uitgeschakeld wanneer deze is ingesteld op onwaar

properties.provisioningState

ProvisioningState

Vertegenwoordigt de inrichtingsstatus van de opslagtaak.

properties.taskVersion

integer (int64)

minimum: 1
maximum: 1

Versie van opslagtaak.

systemData

systemData

Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.

tags

object

Resourcetags.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

StorageTaskAction

De actie opslagtaak vertegenwoordigt voorwaardelijke instructies en bewerkingen die moeten worden uitgevoerd op doelobjecten.

Name Type Description
else

ElseCondition

Het restblok van de opslagtaakbewerking

if

IfCondition

Het if-blok van de opslagtaakbewerking

StorageTaskOperation

Vertegenwoordigt een bewerking die moet worden uitgevoerd op het object

Name Type Description
name

StorageTaskOperationName

De bewerking die moet worden uitgevoerd op het object.

onFailure

OnFailure

Er moet actie worden ondernomen wanneer de bewerking voor een object mislukt.

onSuccess

OnSuccess

Er moet actie worden ondernomen wanneer de bewerking voor een object is geslaagd.

parameters

object

Sleutelwaardeparameters voor de bewerking.

StorageTaskOperationName

De bewerking die moet worden uitgevoerd op het object.

Waarde Description
SetBlobTier
SetBlobTags
SetBlobImmutabilityPolicy
SetBlobLegalHold
SetBlobExpiry
DeleteBlob
UndeleteBlob

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit waarmee de resource is gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string (date-time)

De tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UserAssignedIdentity

Door de gebruiker toegewezen identiteitseigenschappen

Name Type Description
clientId

string (uuid)

De client-id van de toegewezen identiteit.

principalId

string (uuid)

De principal-id van de toegewezen identiteit.