az storage entity

Tabelopslagentiteiten beheren.

Opdracht

az storage entity delete

Hiermee verwijdert u een bestaande entiteit in een tabel.

az storage entity insert

Voeg een entiteit in een tabel in.

az storage entity merge

Werkt een bestaande entiteit bij door de eigenschappen van de entiteit samen te voegen.

az storage entity query

Entiteiten weer te geven die voldoen aan een query.

az storage entity replace

Werkt een bestaande entiteit in een tabel bij.

az storage entity show

Haal een entiteit op uit de opgegeven tabel.

az storage entity delete

Hiermee verwijdert u een bestaande entiteit in een tabel.

Geeft aan als de entiteit niet bestaat. Wanneer een entiteit is verwijderd, wordt de entiteit onmiddellijk gemarkeerd voor verwijdering en is deze niet meer toegankelijk voor clients. De entiteit wordt later verwijderd uit de Tabelservice tijdens garbageverzameling.

az storage entity delete --partition-key
                         --row-key
                         --table-name
                         [--account-key]
                         [--account-name]
                         [--connection-string]
                         [--if-match]
                         [--sas-token]
                         [--subscription]
                         [--timeout]

Vereiste parameters

--partition-key

De PartitionKey van de entiteit.

--row-key

De RowKey van de entiteit.

--table-name -t

De naam van de tabel die de entiteit bevat die moet worden verwijderd.

Optionele parameters

--account-key

Storage accountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met een opslagaccountsleutel of een SAS-token. Als geen van beide aanwezig is, probeert de opdracht een query uit te voeren op de sleutel van het opslagaccount met behulp van het geverifieerde Azure-account. Als een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--connection-string

Storage account connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--if-match

De client kan de ETag voor de entiteit op de aanvraag opgeven om te vergelijken met de ETag die wordt onderhouden door de service met het oog op optimistische gelijktijdigheid. De verwijderbewerking wordt alleen uitgevoerd als de ETag die wordt verzonden door de client overeenkomt met de waarde die wordt onderhouden door de server, wat aangeeft dat de entiteit niet is gewijzigd sinds deze is opgehaald door de client. Als u een onvoorwaardelijke verwijderen wilt forceer, If-Match op het jokerteken ( * ).

--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--timeout

Time-out aanvragen in seconden. Is van toepassing op elke aanroep naar de service.

az storage entity insert

Voeg een entiteit in een tabel in.

az storage entity insert --entity
                         --table-name
                         [--account-key]
                         [--account-name]
                         [--connection-string]
                         [--if-exists {fail, merge, replace}]
                         [--sas-token]
                         [--subscription]
                         [--timeout]

Voorbeelden

Voeg een entiteit in een tabel in. (automatisch gegenereerd)

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

Vereiste parameters

--entity -e

Door spaties gescheiden lijst met sleutel-waardeparen. Moet een PartitionKey en een RowKey bevatten.

--table-name -t

De naam van de tabel waar de entiteit in moet worden invoegen.

Optionele parameters

--account-key

Storage accountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met een opslagaccountsleutel of een SAS-token. Als geen van beide aanwezig is, probeert de opdracht een query uit te voeren op de sleutel van het opslagaccount met behulp van het geverifieerde Azure-account. Als een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--connection-string

Storage account connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--if-exists

Gedrag wanneer er al een entiteit bestaat voor de opgegeven PartitionKey en RowKey.

geaccepteerde waarden: fail, merge, replace
standaardwaarde: fail
--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--timeout

De time-out van de server, uitgedrukt in seconden.

az storage entity merge

Werkt een bestaande entiteit bij door de eigenschappen van de entiteit samen te voegen.

Geeft weer als de entiteit niet bestaat. Deze bewerking vervangt niet de bestaande entiteit zoals de update_entity bewerking doet. Een eigenschap kan niet worden verwijderd met merge_entity. Eigenschappen met null-waarden worden genegeerd. Alle andere eigenschappen worden bijgewerkt of toegevoegd.

az storage entity merge --entity
                        --table-name
                        [--account-key]
                        [--account-name]
                        [--connection-string]
                        [--if-match]
                        [--sas-token]
                        [--subscription]
                        [--timeout]

Vereiste parameters

--entity -e

De entiteit die moet worden samengevoegd. Kan een dict of een entiteitsobject zijn. Moet een PartitionKey en een RowKey bevatten.

--table-name -t

De naam van de tabel met de entiteit die moet worden samengevoegd.

Optionele parameters

--account-key

Storage accountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met een opslagaccountsleutel of een SAS-token. Als geen van beide aanwezig is, probeert de opdracht een query uit te voeren op de sleutel van het opslagaccount met behulp van het geverifieerde Azure-account. Als een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--connection-string

Storage account connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--if-match

De client kan de ETag voor de entiteit op de aanvraag opgeven om te vergelijken met de ETag die wordt onderhouden door de service met het oog op optimistische gelijktijdigheid. De samenvoegingsbewerking wordt alleen uitgevoerd als de ETag die door de client wordt verzonden overeenkomt met de waarde die wordt onderhouden door de server, wat aangeeft dat de entiteit niet is gewijzigd sinds deze is opgehaald door de client. Als u een onvoorwaardelijke samenvoeging wilt forceren, stelt If-Match in op het jokerteken ( * ).

--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--timeout

Time-out aanvragen in seconden. Is van toepassing op elke aanroep naar de service.

az storage entity query

Entiteiten weer te geven die voldoen aan een query.

az storage entity query --table-name
                        [--accept {full, minimal, none}]
                        [--account-key]
                        [--account-name]
                        [--connection-string]
                        [--filter]
                        [--marker]
                        [--num-results]
                        [--sas-token]
                        [--select]
                        [--subscription]
                        [--timeout]

Voorbeelden

Entiteiten weer te geven die voldoen aan een query. (automatisch gegenereerd)

az storage entity query --table-name MyTable

Vereiste parameters

--table-name -t

De naam van de tabel die moet worden opgevraagd.

Optionele parameters

--accept

Hiermee geeft u op hoeveel metagegevens moeten worden opgeslagen in de nettolading van het antwoord.

geaccepteerde waarden: full, minimal, none
standaardwaarde: minimal
--account-key

Storage accountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met een opslagaccountsleutel of een SAS-token. Als geen van beide aanwezig is, probeert de opdracht een query uit te voeren op de sleutel van het opslagaccount met behulp van het geverifieerde Azure-account. Als een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--connection-string

Storage account connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--filter

Retourneert alleen entiteiten die voldoen aan het opgegeven filter. Houd er rekening mee dat er niet meer dan 15 afzonderlijke vergelijkingen zijn toegestaan binnen een $filter tekenreeks. Zie http://msdn.microsoft.com/en-us/library/windowsazure/dd894031.aspx voor meer informatie over het maken van filters.

--marker

Door spaties gescheiden lijst met sleutel-waardeparen. Moet een nextpartitionkey en een nextrowkey bevatten.

--num-results

Het maximum aantal entiteiten dat moet worden retourneren.

--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--select

Door spaties gescheiden lijst met eigenschappen die voor elke entiteit moeten worden teruggekoppeld.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--timeout

Time-out aanvragen in seconden. Is van toepassing op elke aanroep naar de service.

az storage entity replace

Werkt een bestaande entiteit in een tabel bij.

Geeft aan als de entiteit niet bestaat. De update_entity vervangt de hele entiteit en kan worden gebruikt om eigenschappen te verwijderen.

az storage entity replace --entity
                          --table-name
                          [--account-key]
                          [--account-name]
                          [--connection-string]
                          [--if-match]
                          [--sas-token]
                          [--subscription]
                          [--timeout]

Vereiste parameters

--entity -e

De entiteit die moet worden bijgewerkt. Kan een dict of een entiteitsobject zijn. Moet een PartitionKey en een RowKey bevatten.

--table-name -t

De naam van de tabel met de entiteit die moet worden bijgewerkt.

Optionele parameters

--account-key

Storage accountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met een opslagaccountsleutel of een SAS-token. Als geen van beide aanwezig is, probeert de opdracht de sleutel van het opslagaccount op te vragen met behulp van het geverifieerde Azure-account. Als een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--connection-string

Storage account connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--if-match

De client kan de ETag voor de entiteit op de aanvraag opgeven om te vergelijken met de ETag die wordt onderhouden door de service met het oog op optimistische gelijktijdigheid. De updatebewerking wordt alleen uitgevoerd als de ETag die wordt verzonden door de client overeenkomt met de waarde die wordt onderhouden door de server, wat aangeeft dat de entiteit niet is gewijzigd sinds deze is opgehaald door de client. Als u een onvoorwaardelijke update wilt forceer, stelt If-Match in op het jokerteken ( * ).

--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--timeout

Time-out aanvragen in seconden. Is van toepassing op elke aanroep naar de service.

az storage entity show

Haal een entiteit op uit de opgegeven tabel.

Geeft aan als de entiteit niet bestaat.

az storage entity show --partition-key
                       --row-key
                       --table-name
                       [--accept]
                       [--account-key]
                       [--account-name]
                       [--connection-string]
                       [--query-examples]
                       [--sas-token]
                       [--select]
                       [--subscription]
                       [--timeout]

Vereiste parameters

--partition-key

De PartitionKey van de entiteit.

--row-key

De RowKey van de entiteit.

--table-name -t

De naam van de tabel waar de entiteit uit moet worden op halen.

Optionele parameters

--accept

Hiermee geeft u het geaccepteerde inhoudstype van de nettolading van het antwoord op. Zie TablePayloadFormat voor mogelijke waarden.

standaardwaarde: application/json;odata=minimalmetadata
--account-key

Storage accountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met een opslagaccountsleutel of een SAS-token. Als geen van beide aanwezig is, probeert de opdracht de sleutel van het opslagaccount op te vragen met behulp van het geverifieerde Azure-account. Als een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--connection-string

Storage account connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiƫren en deze na de parameter --query tussen dubbele aanhalingstekens plakken om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--select

Door spaties gescheiden lijst met eigenschappen die voor elke entiteit moeten worden teruggekoppeld.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--timeout

Time-out aanvragen in seconden. Is van toepassing op elke aanroep naar de service.