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 |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
De naam van de resourcegroep. De naam is niet hoofdlettergevoelig. |
|
storage
|
path | True |
string minLength: 3maxLength: 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. |
|
subscription
|
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 |
De beheerde service-identiteit van de resource. |
|
| location | True |
string |
De geografische locatie waar de resource zich bevindt |
| properties.action | True |
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 |
De updatebewerking van de resource 'StorageTask' is geslaagd |
|
| 201 Created |
Resource 'StorageTask' bewerking maken geslaagd Kopteksten
|
|
| 202 Accepted |
Resourcebewerking geaccepteerd. Kopteksten
|
|
| Other Status Codes |
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 |
|---|---|
|
created |
Het type identiteit waarmee de resource is gemaakt. |
|
Else |
Het restblok van de opslagtaakbewerking |
|
Error |
Aanvullende informatie over de resourcebeheerfout. |
|
Error |
De foutdetails. |
|
Error |
Foutreactie |
|
If |
Het if-blok van de opslagtaakbewerking |
|
Managed |
Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten) |
|
Managed |
Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). |
|
On |
Er moet actie worden ondernomen wanneer de bewerking voor een object mislukt. |
|
On |
Er moet actie worden ondernomen wanneer de bewerking voor een object is geslaagd. |
|
Provisioning |
Vertegenwoordigt de inrichtingsstatus van de opslagtaak. |
|
Storage |
Vertegenwoordigt opslagtaak. |
|
Storage |
De actie opslagtaak vertegenwoordigt voorwaardelijke instructies en bewerkingen die moeten worden uitgevoerd op doelobjecten. |
|
Storage |
Vertegenwoordigt een bewerking die moet worden uitgevoerd op het object |
|
Storage |
De bewerking die moet worden uitgevoerd op het object. |
|
system |
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource. |
|
User |
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 |
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 |
De fout bevat aanvullende informatie. |
|
| code |
string |
De foutcode. |
| details |
De foutdetails. |
|
| message |
string |
Het foutbericht. |
| target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
| Name | Type | Description |
|---|---|---|
| error |
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 |
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 |
Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). |
|
| userAssignedIdentities |
<string,
User |
User-Assigned identiteiten |
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 |
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 |
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 |
Vertegenwoordigt de inrichtingsstatus van de opslagtaak. |
|
| properties.taskVersion |
integer (int64) minimum: 1maximum: 1 |
Versie van opslagtaak. |
| 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 |
Het restblok van de opslagtaakbewerking |
|
| if |
Het if-blok van de opslagtaakbewerking |
StorageTaskOperation
Vertegenwoordigt een bewerking die moet worden uitgevoerd op het object
| Name | Type | Description |
|---|---|---|
| name |
De bewerking die moet worden uitgevoerd op het object. |
|
| 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. |
|
| 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 |
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 |
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. |