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

Item class

包:

@azure/cosmos

用于对特定项执行作。

有关所有项的作，请参阅 项;请参阅 container.items。

属性

container
id
url	返回资源的引用 URL。 用于在权限中链接。

方法

delete<T>(RequestOptions)	删除项目。 SDK 不一定强制实施任何提供的类型 T。 可能会获取或多或少的属性，并且由逻辑来强制实施。
patch<T>(PatchRequestBody, RequestOptions)	对项执行 JSONPatch。 SDK 不一定强制实施任何提供的类型 T。 可能会获取或多或少的属性，并且由逻辑来强制实施。
read<T>(RequestOptions)	读取项的定义。 SDK 不一定强制实施任何提供的类型 T。 可能会获取或多或少的属性，并且由逻辑来强制实施。 如果类型 T 是类，则不会传递 typeof 比较，因为它没有匹配原型。 建议仅使用接口。 JSON 项没有设置架构。 它们可能包含任意数量的自定义属性。 示例 对响应使用自定义类型 interface TodoItem { title: string; done: bool; id: string; } let item: TodoItem; ({body: item} = await item.read<TodoItem>());
replace(ItemDefinition, RequestOptions)	替换项的定义。 JSON 项没有设置架构。 它们可能包含任意数量的自定义属性。
replace<T>(T, RequestOptions)	替换项的定义。 SDK 不一定强制实施任何提供的类型 T。 可能会获取或多或少的属性，并且由逻辑来强制实施。 JSON 项没有设置架构。 它们可能包含任意数量的自定义属性。

属性详细信息

container

container: Container

属性值

Container

id

id: string

属性值

string

url

返回资源的引用 URL。 用于在权限中链接。

string url

属性值

string

方法详细信息

delete<T>(RequestOptions)

删除项目。

SDK 不一定强制实施任何提供的类型 T。 可能会获取或多或少的属性，并且由逻辑来强制实施。

function delete<T>(options?: RequestOptions): Promise<ItemResponse<T>>

参数

options

RequestOptions

请求的其他选项

返回

Promise<ItemResponse<T>>

patch<T>(PatchRequestBody, RequestOptions)

对项执行 JSONPatch。

SDK 不一定强制实施任何提供的类型 T。 可能会获取或多或少的属性，并且由逻辑来强制实施。

function patch<T>(body: PatchRequestBody, options?: RequestOptions): Promise<ItemResponse<T>>

参数

body

PatchRequestBody

options

RequestOptions

请求的其他选项

返回

Promise<ItemResponse<T>>

read<T>(RequestOptions)

读取项的定义。

SDK 不一定强制实施任何提供的类型 T。 可能会获取或多或少的属性，并且由逻辑来强制实施。 如果类型 T 是类，则不会传递 typeof 比较，因为它没有匹配原型。 建议仅使用接口。

JSON 项没有设置架构。 它们可能包含任意数量的自定义属性。

示例

对响应使用自定义类型

interface TodoItem {
  title: string;
  done: bool;
  id: string;
}

let item: TodoItem;
({body: item} = await item.read<TodoItem>());

function read<T>(options?: RequestOptions): Promise<ItemResponse<T>>

参数

options

RequestOptions

请求的其他选项

返回

Promise<ItemResponse<T>>

replace(ItemDefinition, RequestOptions)

替换项的定义。

JSON 项没有设置架构。 它们可能包含任意数量的自定义属性。

function replace(body: ItemDefinition, options?: RequestOptions): Promise<ItemResponse<ItemDefinition>>

参数

body

ItemDefinition

将现有 项的定义替换为的定义。

options

RequestOptions

请求的其他选项

返回

Promise<ItemResponse<ItemDefinition>>

replace<T>(T, RequestOptions)

替换项的定义。

SDK 不一定强制实施任何提供的类型 T。 可能会获取或多或少的属性，并且由逻辑来强制实施。

JSON 项没有设置架构。 它们可能包含任意数量的自定义属性。

function replace<T>(body: T, options?: RequestOptions): Promise<ItemResponse<T>>

参数

body

T

将现有 项的定义替换为的定义。

options

RequestOptions

请求的其他选项

返回

Promise<ItemResponse<T>>