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á tiver sido 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á tiver sido 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 do URI
| Name | Em | Necessá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 das tarefas de armazenamento devem ter entre 3 e 18 caracteres e usar apenas números e letras minúsculas. |
|
subscription
|
path | True |
string (uuid) |
A ID da assinatura de destino. O valor deve ser um UUID. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a ser usada para esta operação. |
Corpo do Pedido
| Name | Necessário | Tipo | Description |
|---|---|---|---|
| identity | True |
A identidade do serviço gerenciado do recurso. |
|
| location | True |
string |
A geolocalização onde o recurso vive |
| properties.action | True |
A ação da tarefa de armazenamento que é executada |
|
| properties.description | True |
string |
Texto que descreve a finalidade da tarefa de armazenamento |
| properties.enabled | True |
boolean |
A Tarefa de Armazenamento é ativada quando definida como true e desativada quando definida como false |
| tags |
object |
Tags de recursos. |
Respostas
| Name | Tipo | Description |
|---|---|---|
| 200 OK |
Operação de atualização do recurso 'StorageTask' bem-sucedida |
|
| 201 Created |
Operação de criação de recurso 'StorageTask' bem-sucedida Cabeçalhos
|
|
| 202 Accepted |
Operação de recurso aceita. Cabeçalhos
|
|
| Other Status Codes |
Uma resposta de erro inesperada. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory.
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
| Name | Description |
|---|---|
| user_impersonation | personificar a sua conta de utilizador |
Exemplos
PutStorageTask
Pedido de amostra
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
}
}
Resposta da amostra
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
Definições
| Name | Description |
|---|---|
|
created |
O tipo de identidade que criou o recurso. |
|
Else |
O bloco else da operação da tarefa de armazenamento |
|
Error |
O erro de gerenciamento de recursos informações adicionais. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
|
If |
O bloco if da operação da tarefa de armazenamento |
|
Managed |
Identidade do serviço gerenciado (identidades atribuídas pelo sistema e/ou pelo usuário) |
|
Managed |
Tipo de identidade de serviço gerenciado (onde 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 referentes à 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 |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ElseCondition
O bloco else da operação da tarefa de armazenamento
| Name | Tipo | Description |
|---|---|---|
| operations |
Lista de operações a serem executadas no bloco else |
ErrorAdditionalInfo
O erro de gerenciamento de recursos informações adicionais.
| Name | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Name | Tipo | Description |
|---|---|---|
| additionalInfo |
O erro informações adicionais. |
|
| 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
| Name | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |
IfCondition
O bloco if da operação da tarefa de armazenamento
| Name | Tipo | Description |
|---|---|---|
| condition |
string |
Predicado de condição para avaliar cada objeto. Consulte https://aka.ms/storagetaskconditions para propriedades e operadores válidos. |
| operations |
Lista de operações a executar quando o predicado da condição satisfaz. |
ManagedServiceIdentity
Identidade do serviço gerenciado (identidades atribuídas pelo sistema e/ou pelo usuário)
| Name | Tipo | Description |
|---|---|---|
| principalId |
string (uuid) |
O ID da entidade de serviço da identidade atribuída ao sistema. Esta propriedade só será fornecida para uma identidade atribuída ao sistema. |
| tenantId |
string (uuid) |
O ID do locatário da identidade atribuída ao sistema. Esta propriedade só será fornecida para uma identidade atribuída ao sistema. |
| type |
Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). |
|
| userAssignedIdentities |
<string,
User |
User-Assigned Identidades |
ManagedServiceIdentityType
Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).
| Valor | Description |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,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 |
|---|---|
| ValidateSubscriptionQuotaBegin | |
| ValidateSubscriptionQuotaEnd | |
| Accepted | |
| Creating | |
| Succeeded | |
| Deleting | |
| Canceled | |
| Failed |
StorageTask
Representa a tarefa de armazenamento.
| Name | Tipo | Description |
|---|---|---|
| id |
string (arm-id) |
ID de recurso totalmente qualificado 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 geolocalização onde o recurso vive |
| name |
string |
O nome do recurso |
| properties.action |
A ação da tarefa de armazenamento que é executada |
|
| properties.creationTimeInUtc |
string (date-time) |
A data e 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 é ativada quando definida como true e desativada 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 contendo informações createdBy e modifiedBy. |
|
| tags |
object |
Tags de recursos. |
| 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.
| Name | Tipo | Description |
|---|---|---|
| else |
O bloco else da operação da tarefa de armazenamento |
|
| if |
O bloco if da operação da tarefa de armazenamento |
StorageTaskOperation
Representa uma operação a ser executada no objeto
| Name | 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 |
|---|---|
| SetBlobTier | |
| SetBlobTags | |
| SetBlobImmutabilityPolicy | |
| SetBlobLegalHold | |
| SetBlobExpiry | |
| DeleteBlob | |
| UndeleteBlob |
systemData
Metadados referentes à criação e última modificação do recurso.
| Name | 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
| Name | Tipo | Description |
|---|---|---|
| clientId |
string (uuid) |
O ID do cliente da identidade atribuída. |
| principalId |
string (uuid) |
O ID principal da identidade atribuída. |