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

Table Resources - Create Update Table

Create或更新 Azure Cosmos DB 表

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/tables/{tableName}?api-version=2024-05-15

URI 参数

名称 必需 类型 说明
accountName
path True

string

Cosmos DB 数据库帐户名称。

正则表达式模式: ^[a-z0-9]+(-[a-z0-9]+)*

resourceGroupName
path True

string

资源组的名称。 此名称不区分大小写。

subscriptionId
path True

string

目标订阅的 ID。

tableName
path True

string

Cosmos DB 表名称。

api-version
query True

string

要用于此操作的 API 版本。

请求正文

名称 类型 说明
createUpdateTableParameters

TableCreateUpdateParameters

要为当前表提供的参数。

响应

名称 类型 说明
200 OK

TableGetResults

表创建或更新操作已成功完成。

202 Accepted

表创建或更新操作将以异步方式完成。

标头

  • azure-AsyncOperation: string
  • location: string

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

CosmosDBTableReplace

示例请求

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/tables/tableName?api-version=2024-05-15

{
  "location": "West US",
  "tags": {},
  "properties": {
    "resource": {
      "id": "tableName"
    },
    "options": {}
  }
}

示例响应

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/tables/tableName",
  "name": "tableName",
  "type": "Microsoft.DocumentDB/databaseAccounts/tables",
  "location": "West US",
  "properties": {
    "resource": {
      "id": "tableName"
    }
  }
}

定义

名称 说明
AutoscaleSettings
CreateMode

用于指示帐户创建模式的枚举。

CreateUpdateOptions

要应用于请求的选项的键值对。 这对应于随请求一起发送的标头。

Options
Resource
ResourceRestoreParameters

指示有关还原的信息的参数。

TableCreateUpdateParameters

要为当前表提供的参数。

TableGetResults

Azure Cosmos DB 表。

TableResource

Cosmos DB 表资源对象

AutoscaleSettings

名称 类型 说明
maxThroughput

integer

表示资源可以纵向扩展到的最大吞吐量。

CreateMode

用于指示帐户创建模式的枚举。

名称 类型 说明
Default

string

Restore

string

CreateUpdateOptions

要应用于请求的选项的键值对。 这对应于随请求一起发送的标头。

名称 类型 说明
autoscaleSettings

AutoscaleSettings

指定自动缩放设置。 注意:需要吞吐量或 autoscaleSettings,但不能同时满足这两项要求。

throughput

integer

每秒请求单位数。 例如,“throughput”:10000。

Options

名称 类型 说明
autoscaleSettings

AutoscaleSettings

指定自动缩放设置。

throughput

integer

Cosmos DB 资源吞吐量或 autoscaleSettings 的值。 检索产品/服务详细信息时,请使用 ThroughputSetting 资源。

Resource

名称 类型 默认值 说明
_etag

string

系统生成的属性,表示乐观并发控制所需的资源 etag。

_rid

string

系统生成的属性。 唯一标识符。

_ts

number

系统生成的属性,表示资源的上次更新时间戳。

createMode

CreateMode

Default

用于指示资源创建模式的枚举。

id

string

Cosmos DB 表的名称

restoreParameters

ResourceRestoreParameters

用于指示有关还原的信息的参数

ResourceRestoreParameters

指示有关还原的信息的参数。

名称 类型 说明
restoreSource

string

必须从中启动还原的可还原数据库帐户的 ID。 例如:/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName}

restoreTimestampInUtc

string

帐户必须还原到的时间 (ISO-8601 格式) 。

TableCreateUpdateParameters

要为当前表提供的参数。

名称 类型 说明
id

string

ARM 资源的唯一资源标识符。

location

string

资源所属的资源组的位置。

name

string

ARM 资源的名称。

properties.options

CreateUpdateOptions

要应用于请求的选项的键值对。 这对应于随请求一起发送的标头。

properties.resource

TableResource

表的标准 JSON 格式

tags

object

标记是描述资源的键值对的列表。 在查看此资源和为此资源分组(跨资源组)时,可以使用这些标记。 最多可以为资源提供 15 个标记。 每个标记的键不能超过 128 个字符,值不能超过 256 个字符。 例如,模板类型的默认体验设置为“defaultExperience”:“Cassandra”。 当前的“defaultExperience”值还包括“Table”、“Graph”、“DocumentDB”和“MongoDB”。

type

string

Azure 资源的类型。

TableGetResults

Azure Cosmos DB 表。

名称 类型 说明
id

string

ARM 资源的唯一资源标识符。

location

string

资源所属的资源组的位置。

name

string

ARM 资源的名称。

properties.options

Options

properties.resource

Resource

tags

object

标记是描述资源的键值对的列表。 在查看此资源和为此资源分组(跨资源组)时,可以使用这些标记。 最多可以为资源提供 15 个标记。 每个标记的键不能超过 128 个字符,值不能超过 256 个字符。 例如,模板类型的默认体验设置为“defaultExperience”:“Cassandra”。 当前的“defaultExperience”值还包括“Table”、“Graph”、“DocumentDB”和“MongoDB”。

type

string

Azure 资源的类型。

TableResource

Cosmos DB 表资源对象

名称 类型 默认值 说明
createMode

CreateMode

Default

用于指示资源创建模式的枚举。

id

string

Cosmos DB 表的名称

restoreParameters

ResourceRestoreParameters

用于指示有关还原的信息的参数