Dela via


az storage entity

Hantera entiteter för tabelllagring.

Kommandon

Name Description Typ Status
az storage entity delete

Ta bort en befintlig entitet i en tabell.

Kärna GA
az storage entity insert

Infoga en entitet i en tabell.

Kärna GA
az storage entity merge

Uppdatera en befintlig entitet genom att slå samman entitetens egenskaper.

Kärna GA
az storage entity query

Lista entiteter som uppfyller en fråga.

Kärna GA
az storage entity replace

Uppdatera en befintlig entitet i en tabell.

Kärna GA
az storage entity show

Hämta en enskild entitet i en tabell.

Kärna GA

az storage entity delete

Ta bort en befintlig entitet i en tabell.

az storage entity delete --partition-key
                         --row-key
                         --table-name
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--connection-string]
                         [--if-match]
                         [--sas-token]
                         [--table-endpoint]

Obligatoriska parametrar

--partition-key

PartitionKey för entiteten.

--row-key

RowKey för entiteten.

--table-name -t

Tabellnamnet.

Valfria parametrar

--account-key

Lagringskontonyckel. Måste användas tillsammans med lagringskontots namn eller tjänstslutpunkt. Miljövariabel: AZURE_STORAGE_KEY.

--account-name

Lagringskontonamn. Relaterad miljövariabel: AZURE_STORAGE_ACCOUNT. Måste användas tillsammans med antingen lagringskontonyckel eller en SAS-token. Om ingen av dem finns försöker kommandot köra frågor mot lagringskontonyckeln med hjälp av det autentiserade Azure-kontot. Om ett stort antal lagringskommandon körs kan API-kvoten nås.

--auth-mode

Läget där kommandot ska köras. "login"-läget använder dina inloggningsuppgifter direkt för autentiseringen. Det äldre nyckelläget försöker fråga efter en kontonyckel om det inte finns några autentiseringsparametrar för kontot. Miljövariabel: AZURE_STORAGE_AUTH_MODE.

Godkända värden: key, login
--connection-string

Anslutningssträng för lagringskonto. Miljövariabel: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Ett ETag-värde eller jokertecknet (*). Ange det här huvudet för att utföra åtgärden endast om resursens ETag matchar det angivna värdet.

Standardvärde: *
--sas-token

En signatur för delad åtkomst (SAS). Måste användas tillsammans med lagringskontots namn eller tjänstslutpunkt. Miljövariabel: AZURE_STORAGE_SAS_TOKEN.

--table-endpoint

Lagringsdatatjänstens slutpunkt. Måste användas tillsammans med antingen lagringskontonyckel eller en SAS-token. Du hittar varje tjänsts primära slutpunkt med az storage account show. Miljövariabel: AZURE_STORAGE_SERVICE_ENDPOINT.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az storage entity insert

Infoga en entitet i en tabell.

az storage entity insert --entity
                         --table-name
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--connection-string]
                         [--if-exists {fail, merge, replace}]
                         [--sas-token]
                         [--table-endpoint]

Exempel

Infoga en entitet i en tabell. (automatiskt genererad)

az storage entity insert --connection-string $connectionString --entity PartitionKey=AAA RowKey=BBB Content=ASDF2 --if-exists fail --table-name MyTable

Infoga en entitet när du anger odatatypen.

az storage entity insert --connection-string $connectionString --entity PartitionKey=AAA RowKey=BBB Content=0152 Content@odata.type=Edm.String --if-exists merge --table-name MyTable

Obligatoriska parametrar

--entity -e

Blankstegsavgränsad lista över key=value-par. Måste innehålla en PartitionKey och en RowKey.

PartitionKey och RowKey måste vara unika i tabellen och kan vara upp till 64 KB stora. Om du använder ett heltalsvärde som en nyckel konverterar du det till en sträng med fast bredd som kan sorteras kanoniskt. Konvertera till exempel heltalsvärdet 1 till strängvärdet "0000001" för att säkerställa korrekt sortering. Om du vill ange värdetypen manuellt kan du lägga till ytterligare ett nyckel/värde-par i formatet key@odata.type=<EdmType> där <EdmType> kan komma från följande lista: Edm.Binary, Edm.Int64, Edm.Guid, Edm.DateTime, Edm.String, Edm.Int32, Edm.Double, Edm.Boolean.

--table-name -t

Namnet på tabellen som entiteten ska infogas i.

Valfria parametrar

--account-key

Lagringskontonyckel. Måste användas tillsammans med lagringskontots namn eller tjänstslutpunkt. Miljövariabel: AZURE_STORAGE_KEY.

--account-name

Lagringskontonamn. Relaterad miljövariabel: AZURE_STORAGE_ACCOUNT. Måste användas tillsammans med antingen lagringskontonyckel eller en SAS-token. Om ingen av dem finns försöker kommandot köra frågor mot lagringskontonyckeln med hjälp av det autentiserade Azure-kontot. Om ett stort antal lagringskommandon körs kan API-kvoten nås.

--auth-mode

Läget där kommandot ska köras. "login"-läget använder dina inloggningsuppgifter direkt för autentiseringen. Det äldre nyckelläget försöker fråga efter en kontonyckel om det inte finns några autentiseringsparametrar för kontot. Miljövariabel: AZURE_STORAGE_AUTH_MODE.

Godkända värden: key, login
--connection-string

Anslutningssträng för lagringskonto. Miljövariabel: AZURE_STORAGE_CONNECTION_STRING.

--if-exists

Beteende när en entitet redan finns för den angivna PartitionKey och RowKey.

Godkända värden: fail, merge, replace
Standardvärde: fail
--sas-token

En signatur för delad åtkomst (SAS). Måste användas tillsammans med lagringskontots namn eller tjänstslutpunkt. Miljövariabel: AZURE_STORAGE_SAS_TOKEN.

--table-endpoint

Lagringsdatatjänstens slutpunkt. Måste användas tillsammans med antingen lagringskontonyckel eller en SAS-token. Du hittar varje tjänsts primära slutpunkt med az storage account show. Miljövariabel: AZURE_STORAGE_SERVICE_ENDPOINT.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az storage entity merge

Uppdatera en befintlig entitet genom att slå samman entitetens egenskaper.

az storage entity merge --entity
                        --table-name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--if-match]
                        [--sas-token]
                        [--table-endpoint]

Obligatoriska parametrar

--entity -e

Blankstegsavgränsad lista över key=value-par. Måste innehålla en PartitionKey och en RowKey.

--table-name -t

Tabellnamnet.

Valfria parametrar

--account-key

Lagringskontonyckel. Måste användas tillsammans med lagringskontots namn eller tjänstslutpunkt. Miljövariabel: AZURE_STORAGE_KEY.

--account-name

Lagringskontonamn. Relaterad miljövariabel: AZURE_STORAGE_ACCOUNT. Måste användas tillsammans med antingen lagringskontonyckel eller en SAS-token. Om ingen av dem finns försöker kommandot köra frågor mot lagringskontonyckeln med hjälp av det autentiserade Azure-kontot. Om ett stort antal lagringskommandon körs kan API-kvoten nås.

--auth-mode

Läget där kommandot ska köras. "login"-läget använder dina inloggningsuppgifter direkt för autentiseringen. Det äldre nyckelläget försöker fråga efter en kontonyckel om det inte finns några autentiseringsparametrar för kontot. Miljövariabel: AZURE_STORAGE_AUTH_MODE.

Godkända värden: key, login
--connection-string

Anslutningssträng för lagringskonto. Miljövariabel: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Ett ETag-värde eller jokertecknet (*). Ange det här huvudet för att utföra åtgärden endast om resursens ETag matchar det angivna värdet.

Standardvärde: *
--sas-token

En signatur för delad åtkomst (SAS). Måste användas tillsammans med lagringskontots namn eller tjänstslutpunkt. Miljövariabel: AZURE_STORAGE_SAS_TOKEN.

--table-endpoint

Lagringsdatatjänstens slutpunkt. Måste användas tillsammans med antingen lagringskontonyckel eller en SAS-token. Du hittar varje tjänsts primära slutpunkt med az storage account show. Miljövariabel: AZURE_STORAGE_SERVICE_ENDPOINT.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az storage entity query

Lista entiteter som uppfyller en fråga.

az storage entity query --table-name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--filter]
                        [--marker]
                        [--num-results]
                        [--sas-token]
                        [--select]
                        [--table-endpoint]

Exempel

Lista entiteter som uppfyller en fråga. (automatiskt genererad)

az storage entity query --table-name MyTable

Obligatoriska parametrar

--table-name -t

Tabellnamnet.

Valfria parametrar

--account-key

Lagringskontonyckel. Måste användas tillsammans med lagringskontots namn eller tjänstslutpunkt. Miljövariabel: AZURE_STORAGE_KEY.

--account-name

Lagringskontonamn. Relaterad miljövariabel: AZURE_STORAGE_ACCOUNT. Måste användas tillsammans med antingen lagringskontonyckel eller en SAS-token. Om ingen av dem finns försöker kommandot köra frågor mot lagringskontonyckeln med hjälp av det autentiserade Azure-kontot. Om ett stort antal lagringskommandon körs kan API-kvoten nås.

--auth-mode

Läget där kommandot ska köras. "login"-läget använder dina inloggningsuppgifter direkt för autentiseringen. Det äldre nyckelläget försöker fråga efter en kontonyckel om det inte finns några autentiseringsparametrar för kontot. Miljövariabel: AZURE_STORAGE_AUTH_MODE.

Godkända värden: key, login
--connection-string

Anslutningssträng för lagringskonto. Miljövariabel: AZURE_STORAGE_CONNECTION_STRING.

--filter

Ange ett filter för att returnera vissa entiteter.

--marker

Blankstegsavgränsad lista över key=value-par. Måste innehålla en nextpartitionkey och en nextrowkey.

Det här värdet kan hämtas från fältet next_marker i ett tidigare generatorobjekt om max_results har angetts och generatorn har räknat upp resultat. Om det anges börjar den här generatorn returnera resultat från den punkt där den tidigare generatorn stoppades.

--num-results

Antal entiteter som returneras per tjänstbegäran.

--sas-token

En signatur för delad åtkomst (SAS). Måste användas tillsammans med lagringskontots namn eller tjänstslutpunkt. Miljövariabel: AZURE_STORAGE_SAS_TOKEN.

--select

Blankstegsavgränsad lista över egenskaper som ska returneras för varje entitet.

--table-endpoint

Lagringsdatatjänstens slutpunkt. Måste användas tillsammans med antingen lagringskontonyckel eller en SAS-token. Du hittar varje tjänsts primära slutpunkt med az storage account show. Miljövariabel: AZURE_STORAGE_SERVICE_ENDPOINT.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az storage entity replace

Uppdatera en befintlig entitet i en tabell.

az storage entity replace --entity
                          --table-name
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--connection-string]
                          [--if-match]
                          [--sas-token]
                          [--table-endpoint]

Obligatoriska parametrar

--entity -e

Blankstegsavgränsad lista över key=value-par. Måste innehålla en PartitionKey och en RowKey.

--table-name -t

Tabellnamnet.

Valfria parametrar

--account-key

Lagringskontonyckel. Måste användas tillsammans med lagringskontots namn eller tjänstslutpunkt. Miljövariabel: AZURE_STORAGE_KEY.

--account-name

Lagringskontonamn. Relaterad miljövariabel: AZURE_STORAGE_ACCOUNT. Måste användas tillsammans med antingen lagringskontonyckel eller en SAS-token. Om ingen av dem finns försöker kommandot köra frågor mot lagringskontonyckeln med hjälp av det autentiserade Azure-kontot. Om ett stort antal lagringskommandon körs kan API-kvoten nås.

--auth-mode

Läget där kommandot ska köras. "login"-läget använder dina inloggningsuppgifter direkt för autentiseringen. Det äldre nyckelläget försöker fråga efter en kontonyckel om det inte finns några autentiseringsparametrar för kontot. Miljövariabel: AZURE_STORAGE_AUTH_MODE.

Godkända värden: key, login
--connection-string

Anslutningssträng för lagringskonto. Miljövariabel: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Ett ETag-värde eller jokertecknet (*). Ange det här huvudet för att utföra åtgärden endast om resursens ETag matchar det angivna värdet.

Standardvärde: *
--sas-token

En signatur för delad åtkomst (SAS). Måste användas tillsammans med lagringskontots namn eller tjänstslutpunkt. Miljövariabel: AZURE_STORAGE_SAS_TOKEN.

--table-endpoint

Lagringsdatatjänstens slutpunkt. Måste användas tillsammans med antingen lagringskontonyckel eller en SAS-token. Du hittar varje tjänsts primära slutpunkt med az storage account show. Miljövariabel: AZURE_STORAGE_SERVICE_ENDPOINT.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az storage entity show

Hämta en enskild entitet i en tabell.

az storage entity show --partition-key
                       --row-key
                       --table-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--sas-token]
                       [--select]
                       [--table-endpoint]

Obligatoriska parametrar

--partition-key

PartitionKey för entiteten.

--row-key

RowKey för entiteten.

--table-name -t

Tabellnamnet.

Valfria parametrar

--account-key

Lagringskontonyckel. Måste användas tillsammans med lagringskontots namn eller tjänstslutpunkt. Miljövariabel: AZURE_STORAGE_KEY.

--account-name

Lagringskontonamn. Relaterad miljövariabel: AZURE_STORAGE_ACCOUNT. Måste användas tillsammans med antingen lagringskontonyckel eller en SAS-token. Om ingen av dem finns försöker kommandot köra frågor mot lagringskontonyckeln med hjälp av det autentiserade Azure-kontot. Om ett stort antal lagringskommandon körs kan API-kvoten nås.

--auth-mode

Läget där kommandot ska köras. "login"-läget använder dina inloggningsuppgifter direkt för autentiseringen. Det äldre nyckelläget försöker fråga efter en kontonyckel om det inte finns några autentiseringsparametrar för kontot. Miljövariabel: AZURE_STORAGE_AUTH_MODE.

Godkända värden: key, login
--connection-string

Anslutningssträng för lagringskonto. Miljövariabel: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

En signatur för delad åtkomst (SAS). Måste användas tillsammans med lagringskontots namn eller tjänstslutpunkt. Miljövariabel: AZURE_STORAGE_SAS_TOKEN.

--select

Blankstegsavgränsad lista över egenskaper som ska returneras för varje entitet.

--table-endpoint

Lagringsdatatjänstens slutpunkt. Måste användas tillsammans med antingen lagringskontonyckel eller en SAS-token. Du hittar varje tjänsts primära slutpunkt med az storage account show. Miljövariabel: AZURE_STORAGE_SERVICE_ENDPOINT.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.