Storage Tasks - Preview Actions

Servizio:: Storage Actions

Versione API:: 2023-01-01

Esegue le condizioni di input sulle proprietà dei metadati dell'oggetto di input e definisce gli oggetti corrispondenti in risposta.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.StorageActions/locations/{location}/previewActions?api-version=2023-01-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
location	path	True	string	Rappresenta un'area geografica di Azure in cui risiedono i provider di risorse supportati.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties.action	True	StorageTaskPreviewActionCondition	Anteprima dell'azione da testare
properties.blobs	True	StorageTaskPreviewBlobProperties[]	Proprietà di alcuni BLOB di esempio nel contenitore da testare per verificare le corrispondenze con l'azione di anteprima.
properties.container	True	StorageTaskPreviewContainerProperties	Proprietà di un contenitore di esempio da testare per una corrispondenza con l'azione di anteprima.

Risposte

Nome	Tipo	Descrizione
200 OK	StorageTaskPreviewAction	La richiesta ha avuto esito positivo.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

PerformStorageTaskActionsPreview

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/1f31ba14-ce16-4281-b9b4-3e78da6e1616/providers/Microsoft.StorageActions/locations/eastus/previewActions?api-version=2023-01-01

{
  "properties": {
    "action": {
      "elseBlockExists": true,
      "if": {
        "condition": "[[equals(AccessTier, 'Hot')]]"
      }
    },
    "blobs": [
      {
        "name": "folder1/file1.txt",
        "metadata": [
          {
            "key": "mKey1",
            "value": "mValue1"
          }
        ],
        "properties": [
          {
            "key": "Creation-Time",
            "value": "Wed, 07 Jun 2023 05:23:29 GMT"
          },
          {
            "key": "Last-Modified",
            "value": "Wed, 07 Jun 2023 05:23:29 GMT"
          },
          {
            "key": "Etag",
            "value": "0x8DB67175454D36D"
          },
          {
            "key": "Content-Length",
            "value": "38619"
          },
          {
            "key": "Content-Type",
            "value": "text/xml"
          },
          {
            "key": "Content-Encoding",
            "value": ""
          },
          {
            "key": "Content-Language",
            "value": ""
          },
          {
            "key": "Content-CRC64",
            "value": ""
          },
          {
            "key": "Content-MD5",
            "value": "njr6iDrmU9+FC89WMK22EA=="
          },
          {
            "key": "Cache-Control",
            "value": ""
          },
          {
            "key": "Content-Disposition",
            "value": ""
          },
          {
            "key": "BlobType",
            "value": "BlockBlob"
          },
          {
            "key": "AccessTier",
            "value": "Hot"
          },
          {
            "key": "AccessTierInferred",
            "value": "true"
          },
          {
            "key": "LeaseStatus",
            "value": "unlocked"
          },
          {
            "key": "LeaseState",
            "value": "available"
          },
          {
            "key": "ServerEncrypted",
            "value": "true"
          },
          {
            "key": "TagCount",
            "value": "1"
          }
        ],
        "tags": [
          {
            "key": "tKey1",
            "value": "tValue1"
          }
        ]
      },
      {
        "name": "folder2/file1.txt",
        "metadata": [
          {
            "key": "mKey2",
            "value": "mValue2"
          }
        ],
        "properties": [
          {
            "key": "Creation-Time",
            "value": "Wed, 06 Jun 2023 05:23:29 GMT"
          },
          {
            "key": "Last-Modified",
            "value": "Wed, 06 Jun 2023 05:23:29 GMT"
          },
          {
            "key": "Etag",
            "value": "0x6FB67175454D36D"
          }
        ],
        "tags": [
          {
            "key": "tKey2",
            "value": "tValue2"
          }
        ]
      }
    ],
    "container": {
      "name": "firstContainer",
      "metadata": [
        {
          "key": "mContainerKey1",
          "value": "mContainerValue1"
        }
      ]
    }
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "properties": {
    "action": {
      "elseBlockExists": true,
      "if": {
        "condition": "[[equals(AccessTier, 'Hot')]]"
      }
    },
    "blobs": [
      {
        "name": "folder1/file1.txt",
        "matchedBlock": "If",
        "metadata": [
          {
            "key": "mKey1",
            "value": "mValue1"
          }
        ],
        "properties": [
          {
            "key": "Creation-Time",
            "value": "Wed, 07 Jun 2023 05:23:29 GMT"
          },
          {
            "key": "Last-Modified",
            "value": "Wed, 07 Jun 2023 05:23:29 GMT"
          },
          {
            "key": "Etag",
            "value": "0x8DB67175454D36D"
          },
          {
            "key": "Content-Length",
            "value": "38619"
          },
          {
            "key": "Content-Type",
            "value": "text/xml"
          },
          {
            "key": "Content-Encoding",
            "value": ""
          },
          {
            "key": "Content-Language",
            "value": ""
          },
          {
            "key": "Content-CRC64",
            "value": ""
          },
          {
            "key": "Content-MD5",
            "value": "njr6iDrmU9+FC89WMK22EA=="
          },
          {
            "key": "Cache-Control",
            "value": ""
          },
          {
            "key": "Content-Disposition",
            "value": ""
          },
          {
            "key": "BlobType",
            "value": "BlockBlob"
          },
          {
            "key": "AccessTier",
            "value": "Hot"
          },
          {
            "key": "AccessTierInferred",
            "value": "true"
          },
          {
            "key": "LeaseStatus",
            "value": "unlocked"
          },
          {
            "key": "LeaseState",
            "value": "available"
          },
          {
            "key": "ServerEncrypted",
            "value": "true"
          },
          {
            "key": "TagCount",
            "value": "1"
          }
        ],
        "tags": [
          {
            "key": "tKey1",
            "value": "tValue1"
          }
        ]
      },
      {
        "name": "folder2/file1.txt",
        "matchedBlock": "Else",
        "metadata": [
          {
            "key": "mKey2",
            "value": "mValue2"
          }
        ],
        "properties": [
          {
            "key": "Creation-Time",
            "value": "Wed, 06 Jun 2023 05:23:29 GMT"
          },
          {
            "key": "Last-Modified",
            "value": "Wed, 06 Jun 2023 05:23:29 GMT"
          },
          {
            "key": "Etag",
            "value": "0x6FB67175454D36D"
          }
        ],
        "tags": [
          {
            "key": "tKey2",
            "value": "tValue2"
          }
        ]
      }
    ],
    "container": {
      "name": "firstContainer",
      "metadata": [
        {
          "key": "mContainerKey1",
          "value": "mContainerValue1"
        }
      ]
    }
  }
}

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
MatchedBlockName	Rappresenta il nome del blocco di condizioni che corrisponde alle proprietà del BLOB.
StorageTaskPreviewAction	Azione di anteprima dell'attività di archiviazione.
StorageTaskPreviewActionCondition	Rappresenta le condizioni dell'attività di archiviazione da testare per una corrispondenza con le proprietà del contenitore e del BLOB.
StorageTaskPreviewActionIfCondition	Rappresenta la condizione dell'azione di anteprima dell'attività di archiviazione.
StorageTaskPreviewBlobProperties	Proprietà del contenitore di anteprima dell'attività di archiviazione
StorageTaskPreviewContainerProperties	Proprietà del contenitore di anteprima dell'attività di archiviazione
StorageTaskPreviewKeyValueProperties	Proprietà della coppia chiave chiave dell'oggetto di anteprima dell'attività di archiviazione.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

MatchedBlockName

Enumerazione

Rappresenta il nome del blocco di condizioni che corrisponde alle proprietà del BLOB.

Valore	Descrizione
If
Else
None

StorageTaskPreviewAction

Oggetto

Azione di anteprima dell'attività di archiviazione.

Nome	Tipo	Descrizione
properties.action	StorageTaskPreviewActionCondition	Anteprima dell'azione da testare
properties.blobs	StorageTaskPreviewBlobProperties[]	Proprietà di alcuni BLOB di esempio nel contenitore da testare per verificare le corrispondenze con l'azione di anteprima.
properties.container	StorageTaskPreviewContainerProperties	Proprietà di un contenitore di esempio da testare per una corrispondenza con l'azione di anteprima.

StorageTaskPreviewActionCondition

Oggetto

Rappresenta le condizioni dell'attività di archiviazione da testare per una corrispondenza con le proprietà del contenitore e del BLOB.

Nome	Tipo	Descrizione
elseBlockExists	boolean	Specificare se il blocco else è presente nella condizione.
if	StorageTaskPreviewActionIfCondition	Condizione da testare per una corrispondenza con le proprietà del contenitore e del BLOB.

StorageTaskPreviewActionIfCondition

Oggetto

Rappresenta la condizione dell'azione di anteprima dell'attività di archiviazione.

Nome	Tipo	Descrizione
condition	string	Condizione dell'attività di archiviazione da testare per una corrispondenza.

StorageTaskPreviewBlobProperties

Oggetto

Proprietà del contenitore di anteprima dell'attività di archiviazione

Nome	Tipo	Descrizione
matchedBlock	MatchedBlockName	Rappresenta il nome del blocco di condizioni che corrisponde alle proprietà del BLOB.
metadata	StorageTaskPreviewKeyValueProperties[]	coppie di valori chiave di metadati da testare per una corrispondenza con la condizione specificata.
name	string	Nome del BLOB di test
properties	StorageTaskPreviewKeyValueProperties[]	proprietà coppie chiave valore da testare per una corrispondenza con la condizione specificata.
tags	StorageTaskPreviewKeyValueProperties[]	tag coppie chiave valore da testare per una corrispondenza con la condizione specificata.

StorageTaskPreviewContainerProperties

Oggetto

Proprietà del contenitore di anteprima dell'attività di archiviazione

Nome	Tipo	Descrizione
metadata	StorageTaskPreviewKeyValueProperties[]	coppie di valori chiave di metadati da testare per una corrispondenza con la condizione specificata.
name	string	Nome del contenitore di test

StorageTaskPreviewKeyValueProperties

Oggetto

Proprietà della coppia chiave chiave dell'oggetto di anteprima dell'attività di archiviazione.

Nome	Tipo	Descrizione
key	string	Rappresenta la proprietà chiave della coppia.
value	string	Rappresenta la proprietà value della coppia.