Storage Tasks - Preview Actions

Dienst:

Storage Actions

API-Version:

2023-01-01

Führt die Eingabebedingungen für Eingabeobjektmetadateneigenschaften aus und legt übereinstimmene Objekte als Antwort fest.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
location	path	True	string	Stellt eine Azure-Geografieregion dar, in der sich unterstützte Ressourcenanbieter befinden.
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties.action	True	StorageTaskPreviewActionCondition	Vorschauaktion zum Testen
properties.blobs	True	StorageTaskPreviewBlobProperties[]	Eigenschaften einiger Beispiel-Blobs im Container zum Testen auf Übereinstimmungen mit der Vorschauaktion.
properties.container	True	StorageTaskPreviewContainerProperties	Eigenschaften eines Beispielcontainers zum Testen einer Übereinstimmung mit der Vorschauaktion.

Antworten

Name	Typ	Beschreibung
200 OK	StorageTaskPreviewAction	Die Anforderung ist erfolgreich.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

PerformStorageTaskActionsPreview

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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

Definitionen

Name	Beschreibung
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
MatchedBlockName	Stellt den Bedingungsblocknamen dar, der mit blob-Eigenschaften übereinstimmt.
StorageTaskPreviewAction	Speicheraufgabenvorschauaktion.
StorageTaskPreviewActionCondition	Stellt die Speicheraufgabenbedingungen dar, die für eine Übereinstimmung mit Container- und BLOB-Eigenschaften getestet werden sollen.
StorageTaskPreviewActionIfCondition	Stellt die Aktionsbedingung für die Vorschau der Speicheraufgabe dar.
StorageTaskPreviewBlobProperties	Containereigenschaften für Speicheraufgabenvorschau
StorageTaskPreviewContainerProperties	Containereigenschaften für Speicheraufgabenvorschau
StorageTaskPreviewKeyValueProperties	Eigenschaften des Wertpaars des Speicheraufgabenvorschauobjekts.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

MatchedBlockName

Enumeration

Stellt den Bedingungsblocknamen dar, der mit blob-Eigenschaften übereinstimmt.

Wert	Beschreibung
If
Else
None

StorageTaskPreviewAction

Objekt

Speicheraufgabenvorschauaktion.

Name	Typ	Beschreibung
properties.action	StorageTaskPreviewActionCondition	Vorschauaktion zum Testen
properties.blobs	StorageTaskPreviewBlobProperties[]	Eigenschaften einiger Beispiel-Blobs im Container zum Testen auf Übereinstimmungen mit der Vorschauaktion.
properties.container	StorageTaskPreviewContainerProperties	Eigenschaften eines Beispielcontainers zum Testen einer Übereinstimmung mit der Vorschauaktion.

StorageTaskPreviewActionCondition

Objekt

Stellt die Speicheraufgabenbedingungen dar, die für eine Übereinstimmung mit Container- und BLOB-Eigenschaften getestet werden sollen.

Name	Typ	Beschreibung
elseBlockExists	boolean	Geben Sie an, ob der else-Block in der Bedingung vorhanden ist.
if	StorageTaskPreviewActionIfCondition	Die bedingung, die für eine Übereinstimmung mit Container- und BLOB-Eigenschaften getestet werden soll.

StorageTaskPreviewActionIfCondition

Objekt

Stellt die Aktionsbedingung für die Vorschau der Speicheraufgabe dar.

Name	Typ	Beschreibung
condition	string	Speicheraufgabenbedingung, die für eine Übereinstimmung getestet werden soll.

StorageTaskPreviewBlobProperties

Objekt

Containereigenschaften für Speicheraufgabenvorschau

Name	Typ	Beschreibung
matchedBlock	MatchedBlockName	Stellt den Bedingungsblocknamen dar, der mit blob-Eigenschaften übereinstimmt.
metadata	StorageTaskPreviewKeyValueProperties[]	Metadatenschlüsselwertpaare, die für eine Übereinstimmung mit der bereitgestellten Bedingung getestet werden sollen.
name	string	Name des Test-Blobs
properties	StorageTaskPreviewKeyValueProperties[]	Eigenschaften-Schlüsselwertpaare, die für eine Übereinstimmung mit der bereitgestellten Bedingung getestet werden sollen.
tags	StorageTaskPreviewKeyValueProperties[]	Tags key value pairs to be test for a match against the provided condition.

StorageTaskPreviewContainerProperties

Objekt

Containereigenschaften für Speicheraufgabenvorschau

Name	Typ	Beschreibung
metadata	StorageTaskPreviewKeyValueProperties[]	Metadatenschlüsselwertpaare, die für eine Übereinstimmung mit der bereitgestellten Bedingung getestet werden sollen.
name	string	Name des Testcontainers

StorageTaskPreviewKeyValueProperties

Objekt

Eigenschaften des Wertpaars des Speicheraufgabenvorschauobjekts.

Name	Typ	Beschreibung
key	string	Stellt die Schlüsseleigenschaft des Paares dar.
value	string	Stellt die Werteigenschaft des Paares dar.