Storage Tasks - Create
Cria de forma assíncrona um novo recurso de tarefa de armazenamento com os parâmetros especificados. Se uma tarefa de armazenamento já estiver criada e uma solicitação de criação subsequente for emitida com propriedades diferentes, as propriedades da tarefa de armazenamento serão atualizadas. Se uma tarefa de armazenamento já estiver criada e uma solicitação de criação ou atualização subsequente for emitida com exatamente o mesmo conjunto de propriedades, a solicitação terá êxito.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}?api-version=2023-01-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
storage
|
path | True |
string minLength: 3maxLength: 18 pattern: ^[a-z0-9]{3,18}$ |
O nome da tarefa de armazenamento dentro do grupo de recursos especificado. Os nomes de tarefa de armazenamento devem ter entre 3 e 18 caracteres de comprimento e usar apenas números e letras minúsculas. |
subscription
|
path | True |
string (uuid) |
A ID da assinatura de destino. O valor deve ser uma UUID. |
api-version
|
query | True |
string minLength: 1 |
A versão da API a ser usada para esta operação. |
Corpo da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
identity | True |
A identidade do serviço gerenciado do recurso. |
|
location | True |
string |
A localização geográfica onde o recurso reside |
properties.action | True |
A ação da tarefa de armazenamento executada |
|
properties.description | True |
string |
Texto que descreve a finalidade da tarefa de armazenamento |
properties.enabled | True |
boolean |
A Tarefa de Armazenamento é habilitada quando definida como true e desabilitada quando definida como false |
tags |
object |
Marcas de recurso. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OK -- Atualize a tarefa de armazenamento com as mesmas propriedades especificadas no corpo da solicitação. |
|
201 Created |
OK – Criar tarefa de armazenamento com as mesmas propriedades especificadas no corpo da solicitação. |
|
202 Accepted |
Aceito – Criar ou atualizar solicitação aceita; a operação será concluída de forma assíncrona. Cabeçalhos Location: string |
|
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Exemplos
PutStorageTask
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/1f31ba14-ce16-4281-b9b4-3e78da6e1616/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1?api-version=2023-01-01
{
"location": "westus",
"identity": {
"type": "SystemAssigned"
},
"properties": {
"enabled": true,
"description": "My Storage task",
"action": {
"if": {
"condition": "[[equals(AccessTier, 'Cool')]]",
"operations": [
{
"name": "SetBlobTier",
"parameters": {
"tier": "Hot"
},
"onSuccess": "continue",
"onFailure": "break"
}
]
},
"else": {
"operations": [
{
"name": "DeleteBlob",
"onSuccess": "continue",
"onFailure": "break"
}
]
}
}
}
}
Resposta de exemplo
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
{
"id": "/subscriptions/c86a9c18-8373-41fa-92d4-1d7bdc16977b/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1",
"name": "mytask1",
"type": "Microsoft.StorageActions/storageTasks",
"location": "westus",
"identity": {
"type": "SystemAssigned",
"principalId": "2fd475e8-8923-4597-842f-7ce1adfc6c4a",
"tenantId": "b4a2005c-32c1-434c-bbf0-ff486912fc75"
},
"properties": {
"enabled": true,
"description": "Storage task",
"action": {
"if": {
"condition": "[[equals(AccessTier, 'Cool')]]",
"operations": [
{
"name": "SetBlobTier",
"parameters": {
"tier": "Hot"
},
"onSuccess": "continue",
"onFailure": "break"
}
]
},
"else": {
"operations": [
{
"name": "DeleteBlob",
"onSuccess": "continue",
"onFailure": "break"
}
]
}
},
"taskVersion": 1,
"provisioningState": "Succeeded",
"creationTimeInUtc": "2023-07-06T00:24:59.1441663Z"
}
}
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
{
"id": "/subscriptions/c86a9c18-8373-41fa-92d4-1d7bdc16977b/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1",
"name": "mytask1",
"type": "Microsoft.StorageActions/storageTasks",
"location": "westus",
"identity": {
"type": "SystemAssigned",
"principalId": "2fd475e8-8923-4597-842f-7ce1adfc6c4a",
"tenantId": "b4a2005c-32c1-434c-bbf0-ff486912fc75"
},
"properties": {
"enabled": true,
"description": "Storage task",
"action": {
"if": {
"condition": "[[equals(AccessTier, 'Cool')]]",
"operations": [
{
"name": "SetBlobTier",
"parameters": {
"tier": "Hot"
},
"onSuccess": "continue",
"onFailure": "break"
}
]
},
"else": {
"operations": [
{
"name": "DeleteBlob",
"onSuccess": "continue",
"onFailure": "break"
}
]
}
},
"taskVersion": 1,
"provisioningState": "Succeeded",
"creationTimeInUtc": "2023-07-06T00:24:59.1441663Z"
}
}
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
Definições
Nome | Description |
---|---|
created |
O tipo de identidade que criou o recurso. |
Else |
O outro bloco da operação de tarefa de armazenamento |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta de erro |
If |
O bloco if da operação de tarefa de armazenamento |
Managed |
Identidade de serviço gerenciada (identidades atribuídas pelo sistema e/ou pelo usuário) |
Managed |
Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos). |
on |
Ação a ser tomada quando a operação falhar para um objeto. |
on |
Ação a ser tomada quando a operação for bem-sucedida para um objeto. |
Provisioning |
Representa o estado de provisionamento da tarefa de armazenamento. |
Storage |
Representa a Tarefa de Armazenamento. |
Storage |
A ação da tarefa de armazenamento representa instruções condicionais e operações a serem executadas em objetos de destino. |
Storage |
Representa uma operação a ser executada no objeto |
Storage |
A operação a ser executada no objeto. |
system |
Metadados relativos à criação e última modificação do recurso. |
User |
Propriedades de identidade atribuídas pelo usuário |
createdByType
O tipo de identidade que criou o recurso.
Valor | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
ElseCondition
O outro bloco da operação de tarefa de armazenamento
Nome | Tipo | Description |
---|---|---|
operations |
Lista de operações a serem executadas no outro bloco |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
Nome | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
Nome | Tipo | Description |
---|---|---|
additionalInfo |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
Nome | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
IfCondition
O bloco if da operação de tarefa de armazenamento
Nome | Tipo | Description |
---|---|---|
condition |
string |
Predicado de condição para avaliar cada objeto. Consulte https://aka.ms/storagetaskconditions para obter propriedades e operadores válidos. |
operations |
Lista de operações a serem executadas quando o predicado de condição for atendido. |
ManagedServiceIdentity
Identidade de serviço gerenciada (identidades atribuídas pelo sistema e/ou pelo usuário)
Nome | Tipo | Description |
---|---|---|
principalId |
string (uuid) |
A ID da entidade de serviço da identidade atribuída pelo sistema. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema. |
tenantId |
string (uuid) |
A ID do locatário da identidade atribuída pelo sistema. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema. |
type |
Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos). |
|
userAssignedIdentities |
<string,
User |
Identidades de User-Assigned |
ManagedServiceIdentityType
Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).
Valor | Description |
---|---|
None | |
SystemAssigned | |
SystemAssigned,UserAssigned | |
UserAssigned |
onFailure
Ação a ser tomada quando a operação falhar para um objeto.
Valor | Description |
---|---|
break |
onSuccess
Ação a ser tomada quando a operação for bem-sucedida para um objeto.
Valor | Description |
---|---|
continue |
ProvisioningState
Representa o estado de provisionamento da tarefa de armazenamento.
Valor | Description |
---|---|
Accepted | |
Canceled | |
Creating | |
Deleting | |
Failed | |
Succeeded | |
ValidateSubscriptionQuotaBegin | |
ValidateSubscriptionQuotaEnd |
StorageTask
Representa a Tarefa de Armazenamento.
Nome | Tipo | Description |
---|---|---|
id |
string (arm-id) |
ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
identity |
A identidade do serviço gerenciado do recurso. |
|
location |
string |
A localização geográfica onde o recurso reside |
name |
string |
O nome do recurso |
properties.action |
A ação da tarefa de armazenamento executada |
|
properties.creationTimeInUtc |
string (date-time) |
A data e a hora de criação da tarefa de armazenamento em UTC. |
properties.description |
string |
Texto que descreve a finalidade da tarefa de armazenamento |
properties.enabled |
boolean |
A Tarefa de Armazenamento é habilitada quando definida como true e desabilitada quando definida como false |
properties.provisioningState |
Representa o estado de provisionamento da tarefa de armazenamento. |
|
properties.taskVersion |
integer (int64) minimum: 1maximum: 1 |
Versão da tarefa de armazenamento. |
systemData |
Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy. |
|
tags |
object |
Marcas de recurso. |
type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
StorageTaskAction
A ação da tarefa de armazenamento representa instruções condicionais e operações a serem executadas em objetos de destino.
Nome | Tipo | Description |
---|---|---|
else |
O outro bloco da operação de tarefa de armazenamento |
|
if |
O bloco if da operação de tarefa de armazenamento |
StorageTaskOperation
Representa uma operação a ser executada no objeto
Nome | Tipo | Description |
---|---|---|
name |
A operação a ser executada no objeto. |
|
onFailure |
Ação a ser tomada quando a operação falhar para um objeto. |
|
onSuccess |
Ação a ser tomada quando a operação for bem-sucedida para um objeto. |
|
parameters |
object |
Parâmetros chave-valor para a operação. |
StorageTaskOperationName
A operação a ser executada no objeto.
Valor | Description |
---|---|
DeleteBlob | |
SetBlobExpiry | |
SetBlobImmutabilityPolicy | |
SetBlobLegalHold | |
SetBlobTags | |
SetBlobTier | |
UndeleteBlob |
systemData
Metadados relativos à criação e última modificação do recurso.
Nome | Tipo | Description |
---|---|---|
createdAt |
string (date-time) |
O carimbo de data/hora da criação de recursos (UTC). |
createdBy |
string |
A identidade que criou o recurso. |
createdByType |
O tipo de identidade que criou o recurso. |
|
lastModifiedAt |
string (date-time) |
O carimbo de data/hora da última modificação do recurso (UTC) |
lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |
UserAssignedIdentity
Propriedades de identidade atribuídas pelo usuário
Nome | Tipo | Description |
---|---|---|
clientId |
string (uuid) |
A ID do cliente da identidade atribuída. |
principalId |
string (uuid) |
A ID da entidade de segurança da identidade atribuída. |