通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az storage entity

管理表存储实体。

命令

名称 说明 类型 Status
az storage entity delete

删除表中的现有实体。

 Core GA
az storage entity insert

将实体插入表中。

 Core GA
az storage entity merge

通过合并实体的属性来更新现有实体。

 Core GA
az storage entity query

列出满足查询的实体。

 Core GA
az storage entity replace

更新表中的现有实体。

 Core GA
az storage entity show

获取表中的单个实体。

 Core GA

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。

属性 值
参数组: Storage Account Arguments
--account-name

存储帐户名称。 相关环境变量：AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在，该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令，可能会达到 API 配额限制。

属性 值
参数组: Storage Account Arguments
--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数，则旧版“密钥”模式将尝试查询帐户密钥。 环境变量：AZURE_STORAGE_AUTH_MODE。

属性 值
接受的值: key, login
--connection-string

存储帐户连接字符串。 环境变量：AZURE_STORAGE_CONNECTION_STRING。

属性 值
参数组: Storage Account Arguments
--if-match

ETag 值或通配符 (*)。 仅当资源的 ETag 与指定的值匹配时，才指定此标头来执行该操作。

属性 值
参数组: Precondition Arguments
默认值: *
--sas-token

共享访问签名（SAS）。 必须与存储帐户名称或服务终结点结合使用。 环境变量：AZURE_STORAGE_SAS_TOKEN。

属性 值
参数组: Storage Account Arguments
--table-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量：AZURE_STORAGE_SERVICE_ENDPOINT。

属性 值
参数组: Storage Account Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

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]

示例

将实体插入表中。 (autogenerated)

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 Content@odata.type=Edm.String --if-exists merge --table-name MyTable

必需参数

--entity -e

键=值对的空间分隔列表。 必须包含 PartitionKey 和 RowKey。

PartitionKey 和 RowKey 在表中必须是唯一的，并且大小可能高达 64Kb。 如果将整数值用作键，请将其转换为固定宽度字符串，该字符串可以按音调排序。 例如，将整数值 1 转换为字符串值“0000001”，以确保进行正确的排序。 若要手动指定值类型，可以采用 key@odata.type=<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。

属性 值
参数组: Storage Account Arguments
--account-name

存储帐户名称。 相关环境变量：AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在，该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令，可能会达到 API 配额限制。

属性 值
参数组: Storage Account Arguments
--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数，则旧版“密钥”模式将尝试查询帐户密钥。 环境变量：AZURE_STORAGE_AUTH_MODE。

属性 值
接受的值: key, login
--connection-string

存储帐户连接字符串。 环境变量：AZURE_STORAGE_CONNECTION_STRING。

属性 值
参数组: Storage Account Arguments
--if-exists

指定 PartitionKey 和 RowKey 的实体已存在时的行为。

属性 值
默认值: fail
接受的值: fail, merge, replace
--sas-token

共享访问签名（SAS）。 必须与存储帐户名称或服务终结点结合使用。 环境变量：AZURE_STORAGE_SAS_TOKEN。

属性 值
参数组: Storage Account Arguments
--table-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量：AZURE_STORAGE_SERVICE_ENDPOINT。

属性 值
参数组: Storage Account Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

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

键=值对的空间分隔列表。 必须包含 PartitionKey 和 RowKey。

--table-name -t

表名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量：AZURE_STORAGE_KEY。

属性 值
参数组: Storage Account Arguments
--account-name

存储帐户名称。 相关环境变量：AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在，该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令，可能会达到 API 配额限制。

属性 值
参数组: Storage Account Arguments
--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数，则旧版“密钥”模式将尝试查询帐户密钥。 环境变量：AZURE_STORAGE_AUTH_MODE。

属性 值
接受的值: key, login
--connection-string

存储帐户连接字符串。 环境变量：AZURE_STORAGE_CONNECTION_STRING。

属性 值
参数组: Storage Account Arguments
--if-match

ETag 值或通配符 (*)。 仅当资源的 ETag 与指定的值匹配时，才指定此标头来执行该操作。

属性 值
参数组: Precondition Arguments
默认值: *
--sas-token

共享访问签名（SAS）。 必须与存储帐户名称或服务终结点结合使用。 环境变量：AZURE_STORAGE_SAS_TOKEN。

属性 值
参数组: Storage Account Arguments
--table-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量：AZURE_STORAGE_SERVICE_ENDPOINT。

属性 值
参数组: Storage Account Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

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]

示例

列出满足查询的实体。 (autogenerated)

az storage entity query --table-name MyTable

必需参数

--table-name -t

表名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量：AZURE_STORAGE_KEY。

属性 值
参数组: Storage Account Arguments
--account-name

存储帐户名称。 相关环境变量：AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在，该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令，可能会达到 API 配额限制。

属性 值
参数组: Storage Account Arguments
--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数，则旧版“密钥”模式将尝试查询帐户密钥。 环境变量：AZURE_STORAGE_AUTH_MODE。

属性 值
接受的值: key, login
--connection-string

存储帐户连接字符串。 环境变量：AZURE_STORAGE_CONNECTION_STRING。

属性 值
参数组: Storage Account Arguments
--filter

指定一个筛选器以返回某些实体。

--marker

键=值对的空间分隔列表。 必须包含 nextpartitionkey 和 nextrowkey。

如果指定了max_results并且该生成器已完成枚举结果，则可以从上一个生成器对象的next_marker字段中检索此值。 如果指定，此生成器将从上一个生成器停止的点开始返回结果。

--num-results

每个服务请求返回的实体数。

--sas-token

共享访问签名（SAS）。 必须与存储帐户名称或服务终结点结合使用。 环境变量：AZURE_STORAGE_SAS_TOKEN。

属性 值
参数组: Storage Account Arguments
--select

要为每个实体返回的属性的空格分隔列表。

--table-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量：AZURE_STORAGE_SERVICE_ENDPOINT。

属性 值
参数组: Storage Account Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

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

键=值对的空间分隔列表。 必须包含 PartitionKey 和 RowKey。

--table-name -t

表名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量：AZURE_STORAGE_KEY。

属性 值
参数组: Storage Account Arguments
--account-name

存储帐户名称。 相关环境变量：AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在，该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令，可能会达到 API 配额限制。

属性 值
参数组: Storage Account Arguments
--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数，则旧版“密钥”模式将尝试查询帐户密钥。 环境变量：AZURE_STORAGE_AUTH_MODE。

属性 值
接受的值: key, login
--connection-string

存储帐户连接字符串。 环境变量：AZURE_STORAGE_CONNECTION_STRING。

属性 值
参数组: Storage Account Arguments
--if-match

ETag 值或通配符 (*)。 仅当资源的 ETag 与指定的值匹配时，才指定此标头来执行该操作。

属性 值
参数组: Precondition Arguments
默认值: *
--sas-token

共享访问签名（SAS）。 必须与存储帐户名称或服务终结点结合使用。 环境变量：AZURE_STORAGE_SAS_TOKEN。

属性 值
参数组: Storage Account Arguments
--table-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量：AZURE_STORAGE_SERVICE_ENDPOINT。

属性 值
参数组: Storage Account Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

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。

属性 值
参数组: Storage Account Arguments
--account-name

存储帐户名称。 相关环境变量：AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在，该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令，可能会达到 API 配额限制。

属性 值
参数组: Storage Account Arguments
--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数，则旧版“密钥”模式将尝试查询帐户密钥。 环境变量：AZURE_STORAGE_AUTH_MODE。

属性 值
接受的值: key, login
--connection-string

存储帐户连接字符串。 环境变量：AZURE_STORAGE_CONNECTION_STRING。

属性 值
参数组: Storage Account Arguments
--sas-token

共享访问签名（SAS）。 必须与存储帐户名称或服务终结点结合使用。 环境变量：AZURE_STORAGE_SAS_TOKEN。

属性 值
参数组: Storage Account Arguments
--select

要为每个实体返回的属性的空格分隔列表。

--table-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量：AZURE_STORAGE_SERVICE_ENDPOINT。

属性 值
参数组: Storage Account Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False