az storage blob metadata
Zarządzanie metadanymi obiektów blob.
Polecenia
| Nazwa | Opis | Typ | Stan |
|---|---|---|---|
| az storage blob metadata show |
Zwróć wszystkie metadane zdefiniowane przez użytkownika dla określonego obiektu blob lub migawki. |
Core | ogólna dostępność |
| az storage blob metadata update |
Ustawia metadane zdefiniowane przez użytkownika dla obiektu blob jako co najmniej jedną parę nazwa-wartość. |
Core | ogólna dostępność |
az storage blob metadata show
Zwróć wszystkie metadane zdefiniowane przez użytkownika dla określonego obiektu blob lub migawki.
az storage blob metadata show [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--connection-string]
[--container-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--lease-id]
[--name]
[--sas-token]
[--snapshot]
[--tags-condition]
[--timeout]
Przykłady
Pokaż metadane zdefiniowane przez użytkownika dla obiektu blob.
az storage blob metadata show --container-name mycontainer --name myblob
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Klucz konta przechowywania danych. Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_KEY.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Storage Account Arguments |
Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba komend magazynowania, limit API może zostać osiągnięty.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Storage Account Arguments |
Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | key, login |
Punkt końcowy usługi danych magazynu. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Każdy podstawowy punkt końcowy usługi można znaleźć za pomocą polecenia az storage account show. Zmienna środowiskowa: AZURE_STORAGE_SERVICE_ENDPOINT.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Storage Account Arguments |
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode.
Parametry połączenia konta przechowywania. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Storage Account Arguments |
Nazwa kontenera.
Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Precondition Arguments |
Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Precondition Arguments |
Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, i nie można wykonać operacji, jeśli istnieje.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Precondition Arguments |
Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Precondition Arguments |
Wymagane, jeśli blob ma aktywną dzierżawę.
Nazwa obiektu blob.
Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Storage Account Arguments |
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob do pobrania.
Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Precondition Arguments |
Limit czasu oczekiwania na żądanie w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az storage blob metadata update
Ustawia metadane zdefiniowane przez użytkownika dla obiektu blob jako co najmniej jedną parę nazwa-wartość.
az storage blob metadata update [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--connection-string]
[--container-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--lease-id]
[--metadata]
[--name]
[--sas-token]
[--snapshot]
[--tags-condition]
[--timeout]
Przykłady
Ustaw metadane zdefiniowane przez użytkownika dla obiektu blob.
az storage blob metadata update --container-name mycontainer --name myblob --metadata key=value
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Klucz konta przechowywania danych. Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_KEY.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Storage Account Arguments |
Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba komend magazynowania, limit API może zostać osiągnięty.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Storage Account Arguments |
Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | key, login |
Punkt końcowy usługi danych magazynu. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Każdy podstawowy punkt końcowy usługi można znaleźć za pomocą polecenia az storage account show. Zmienna środowiskowa: AZURE_STORAGE_SERVICE_ENDPOINT.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Storage Account Arguments |
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode.
Parametry połączenia konta przechowywania. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Storage Account Arguments |
Nazwa kontenera.
Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Precondition Arguments |
Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Precondition Arguments |
Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, i nie można wykonać operacji, jeśli istnieje.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Precondition Arguments |
Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Precondition Arguments |
Wymagane, jeśli blob ma aktywną dzierżawę.
Metadane w formacie klucz=wartość, rozdzielone spacjami. Spowoduje to zastąpienie wszystkich istniejących metadanych.
Nazwa obiektu blob.
Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Storage Account Arguments |
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob do pobrania.
Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Precondition Arguments |
Limit czasu oczekiwania na żądanie w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |