使用PowerShell调用Azure Table Storage API分页时认证失败

1. 核心问题：分页参数未正确编码 #

Azure Table Storage API要求NextPartitionKey和NextRowKey必须是URL编码后的字符串，未编码的特殊字符（如/、+、=等）会导致SAS签名验证不通过，触发AuthenticationFailed错误。

2. 具体修复步骤 #

步骤1：对分页参数进行URL编码 #

在PowerShell中使用[Uri]::EscapeDataString()处理从第一页返回的分页标记：

# 从第一页响应中提取的原始值
$nextPartitionKey = "your-partition-key"
$nextRowKey = "your-row-key"

# 编码参数
$encodedPartitionKey = [Uri]::EscapeDataString($nextPartitionKey)
$encodedRowKey = [Uri]::EscapeDataString($nextRowKey)

步骤2：正确构造分页请求URL #

将编码后的参数拼接在基础URL后，再追加SAS Token（注意SAS Token无需二次编码）：

$storageAccount = "your-storage-account"
$tableName = "your-table-name"
$sasToken = "sv=2023-11-03&ss=t&srt=o&sp=r&se=2024-05-01T00:00:00Z&st=2024-04-01T00:00:00Z&spr=https&sig=xxx"

$paginationUrl = "https://$storageAccount.table.core.windows.net/$tableName?NextPartitionKey=$encodedPartitionKey&NextRowKey=$encodedRowKey&$sasToken"

步骤3：保持请求头一致性 #

确保分页请求的请求头与第一页完全一致，比如指定相同的Accept类型：

$headers = @{
    "Accept" = "application/json;odata=nometadata"
}

$response = Invoke-WebRequest -Uri $paginationUrl -Headers $headers -Method Get

3. 额外验证点 #

• 确认SAS Token权限：生成SAS时需包含表的读取权限（sp=r），且资源类型指定为表（srt=t）。
• 避免修改分页参数：必须严格使用第一页返回的NextPartitionKey和NextRowKey原始值，不可手动调整或截断。
• 不二次编码SAS Token：SAS中的sig参数包含签名信息，二次编码会直接破坏签名有效性。

内容的提问来源于stack exchange，提问作者DawnApproach