Поделиться через

az storage entity

  • Ссылка

Управление сущностями хранилища таблиц.

Команды

Имя Описание Тип Состояние
az storage entity delete

Удаление существующей сущности в таблице.

 Ядро ГА
az storage entity insert

Вставка сущности в таблицу.

 Ядро ГА
az storage entity merge

Обновите существующую сущность, объединив свойства сущности.

 Ядро ГА
az storage entity query

Вывод списка сущностей, удовлетворяющих запросу.

 Ядро ГА
az storage entity replace

Обновите существующую сущность в таблице.

 Ядро ГА
az storage entity show

Получение одной сущности в таблице.

 Ядро ГА

az storage entity delete

Изменить

Удаление существующей сущности в таблице.

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]

Обязательные параметры

--partition-key

PartitionKey сущности.

--row-key

RowKey сущности.

--table-name -t

Имя таблицы.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_KEY.

--account-name

Имя учетной записи хранения. Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранения, квота API может быть достигнута.

--auth-mode

Режим выполнения команды. Режим входа будет напрямую использовать учетные данные входа для проверки подлинности. Устаревший режим "ключ" попытается запросить ключ учетной записи, если параметры проверки подлинности для учетной записи не указаны. Переменная среды: AZURE_STORAGE_AUTH_MODE.

Допустимые значения: key, login
--connection-string

Строка подключения учетной записи хранения. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Значение ETag или подстановочный знак (*). Укажите этот заголовок для выполнения операции, только если ETag ресурса соответствует указанному значению.

Default value: *
--sas-token

Подпись для совместного доступа (SAS). Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--table-endpoint

Конечная точка службы данных хранилища. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Вы можете найти каждую основную конечную точку службы с az storage account showпомощью . Переменная среды: AZURE_STORAGE_SERVICE_ENDPOINT.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az storage entity insert

Изменить

Вставка сущности в таблицу.

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]

Примеры

Вставка сущности в таблицу. (автоматическое создание)

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

Вставьте сущность при указании типа odatatype.

az storage entity insert --connection-string $connectionString --entity PartitionKey=AAA RowKey=BBB Content=0152 [email protected]=Edm.String --if-exists merge --table-name MyTable

Обязательные параметры

--entity -e

Разделенный пробелами список пар key=value. Должен содержать partitionKey и RowKey.

PartitionKey и RowKey должны быть уникальными в таблице и могут иметь размер до 64 КБ. При использовании целочисленного значения в качестве ключа преобразуйте его в строку фиксированной ширины, которая может быть канонически отсортирована. Например, преобразуйте целочисленное значение 1 в строковое значение "0000001", чтобы обеспечить правильную сортировку. Чтобы вручную указать тип значения, можно добавить дополнительную пару "ключ", "значение" в формате [email protected]=<EdmType>, где <EdmType> можно получить из следующего списка: Edm.Binary, Edm.Int64, Edm.Guid, Edm.DateTime, Edm.String, Edm.Int32, Edm.Double, Edm.Boolean.

--table-name -t

Имя таблицы для вставки сущности в.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_KEY.

--account-name

Имя учетной записи хранения. Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранения, квота API может быть достигнута.

--auth-mode

Режим выполнения команды. Режим входа будет напрямую использовать учетные данные входа для проверки подлинности. Устаревший режим "ключ" попытается запросить ключ учетной записи, если параметры проверки подлинности для учетной записи не указаны. Переменная среды: AZURE_STORAGE_AUTH_MODE.

Допустимые значения: key, login
--connection-string

Строка подключения учетной записи хранения. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--if-exists

Поведение, когда сущность уже существует для указанного partitionKey и RowKey.

Допустимые значения: fail, merge, replace
Default value: fail
--sas-token

Подпись для совместного доступа (SAS). Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--table-endpoint

Конечная точка службы данных хранилища. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Вы можете найти каждую основную конечную точку службы с az storage account showпомощью . Переменная среды: AZURE_STORAGE_SERVICE_ENDPOINT.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az storage entity merge

Изменить

Обновите существующую сущность, объединив свойства сущности.

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

Обязательные параметры

--entity -e

Разделенный пробелами список пар key=value. Должен содержать partitionKey и RowKey.

--table-name -t

Имя таблицы.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_KEY.

--account-name

Имя учетной записи хранения. Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранения, квота API может быть достигнута.

--auth-mode

Режим выполнения команды. Режим входа будет напрямую использовать учетные данные входа для проверки подлинности. Устаревший режим "ключ" попытается запросить ключ учетной записи, если параметры проверки подлинности для учетной записи не указаны. Переменная среды: AZURE_STORAGE_AUTH_MODE.

Допустимые значения: key, login
--connection-string

Строка подключения учетной записи хранения. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Значение ETag или подстановочный знак (*). Укажите этот заголовок для выполнения операции, только если ETag ресурса соответствует указанному значению.

Default value: *
--sas-token

Подпись для совместного доступа (SAS). Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--table-endpoint

Конечная точка службы данных хранилища. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Вы можете найти каждую основную конечную точку службы с az storage account showпомощью . Переменная среды: AZURE_STORAGE_SERVICE_ENDPOINT.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az storage entity query

Изменить

Вывод списка сущностей, удовлетворяющих запросу.

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]

Примеры

Вывод списка сущностей, удовлетворяющих запросу. (автоматическое создание)

az storage entity query --table-name MyTable

Обязательные параметры

--table-name -t

Имя таблицы.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_KEY.

--account-name

Имя учетной записи хранения. Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранения, квота API может быть достигнута.

--auth-mode

Режим выполнения команды. Режим входа будет напрямую использовать учетные данные входа для проверки подлинности. Устаревший режим "ключ" попытается запросить ключ учетной записи, если параметры проверки подлинности для учетной записи не указаны. Переменная среды: AZURE_STORAGE_AUTH_MODE.

Допустимые значения: key, login
--connection-string

Строка подключения учетной записи хранения. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--filter

Укажите фильтр для возврата определенных сущностей.

--marker

Разделенный пробелами список пар key=value. Должен содержать следующий раздел и nextrowkey.

Это значение можно получить из поля next_marker предыдущего объекта генератора, если был указан max_results и что генератор завершил перечисление результатов. Если задано, этот генератор начнет возвращать результаты с точки, где остановлен предыдущий генератор.

--num-results

Количество сущностей, возвращаемых на запрос службы.

--sas-token

Подпись для совместного доступа (SAS). Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--select

Разделенный пробелом список свойств, возвращаемых для каждой сущности.

--table-endpoint

Конечная точка службы данных хранилища. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Вы можете найти каждую основную конечную точку службы с az storage account showпомощью . Переменная среды: AZURE_STORAGE_SERVICE_ENDPOINT.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az storage entity replace

Изменить

Обновите существующую сущность в таблице.

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

Обязательные параметры

--entity -e

Разделенный пробелами список пар key=value. Должен содержать partitionKey и RowKey.

--table-name -t

Имя таблицы.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_KEY.

--account-name

Имя учетной записи хранения. Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранения, квота API может быть достигнута.

--auth-mode

Режим выполнения команды. Режим входа будет напрямую использовать учетные данные входа для проверки подлинности. Устаревший режим "ключ" попытается запросить ключ учетной записи, если параметры проверки подлинности для учетной записи не указаны. Переменная среды: AZURE_STORAGE_AUTH_MODE.

Допустимые значения: key, login
--connection-string

Строка подключения учетной записи хранения. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Значение ETag или подстановочный знак (*). Укажите этот заголовок для выполнения операции, только если ETag ресурса соответствует указанному значению.

Default value: *
--sas-token

Подпись для совместного доступа (SAS). Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--table-endpoint

Конечная точка службы данных хранилища. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Вы можете найти каждую основную конечную точку службы с az storage account showпомощью . Переменная среды: AZURE_STORAGE_SERVICE_ENDPOINT.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az storage entity show

Изменить

Получение одной сущности в таблице.

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]

Обязательные параметры

--partition-key

PartitionKey сущности.

--row-key

RowKey сущности.

--table-name -t

Имя таблицы.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_KEY.

--account-name

Имя учетной записи хранения. Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранения, квота API может быть достигнута.

--auth-mode

Режим выполнения команды. Режим входа будет напрямую использовать учетные данные входа для проверки подлинности. Устаревший режим "ключ" попытается запросить ключ учетной записи, если параметры проверки подлинности для учетной записи не указаны. Переменная среды: AZURE_STORAGE_AUTH_MODE.

Допустимые значения: key, login
--connection-string

Строка подключения учетной записи хранения. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

Подпись для совместного доступа (SAS). Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--select

Разделенный пробелом список свойств, возвращаемых для каждой сущности.

--table-endpoint

Конечная точка службы данных хранилища. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Вы можете найти каждую основную конечную точку службы с az storage account showпомощью . Переменная среды: AZURE_STORAGE_SERVICE_ENDPOINT.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.