Pages - Delete

服务:

Wiki

API 版本:

5.0

删除 Wiki 页面。

DELETE https://dev.azure.com/{organization}/{project}/_apis/wiki/wikis/{wikiIdentifier}/pages?path={path}&api-version=5.0

具有可选参数:

DELETE https://dev.azure.com/{organization}/{project}/_apis/wiki/wikis/{wikiIdentifier}/pages?path={path}&comment={comment}&api-version=5.0

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
project	path	True	string	项目 ID 或项目名称
wikiIdentifier	path	True	string	Wiki ID 或名称。
api-version	query	True	string	要使用的 API 版本。 这应设置为“5.0”才能使用此版本的 API。
path	query	True	string	Wiki 页面路径。
comment	query		string	要与此页删除关联的注释。

响应

名称	类型	说明
200 OK	WikiPage	页面已删除。 标头 ETag: string

安全性

oauth2

类型: oauth2
流向: accessCode
授权 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
令牌 URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

作用域

名称	说明
vso.wiki_write	授予读取、创建和更新 Wiki、Wiki 网页和 Wiki 附件的功能。

示例

示例请求

HTTP

DELETE https://dev.azure.com/fabrikam/{project}/_apis/wiki/wikis/{wikiIdentifier}/pages?path=/SamplePage129&api-version=5.0

示例响应

状态代码:

200

eTag: ""

{
  "path": "/SamplePage129",
  "order": 9,
  "gitItemPath": "/SamplePage129.md",
  "subPages": [],
  "url": "https://dev.azure.com/fabrikam/15cbba90-8ac5-450e-934c-16f43021546b/_apis/wiki/wikis/0ede3074-ce9f-4e0e-b9d6-20c23b774e05/pages/SamplePage129",
  "remoteUrl": "https://dev.azure.com/fabrikam/15cbba90-8ac5-450e-934c-16f43021546b/_wiki/wikis/0ede3074-ce9f-4e0e-b9d6-20c23b774e05?pagePath=%2FSamplePage129",
  "content": ""
}

定义

WikiPage

Object

定义 Wiki 中的页面。

名称	类型	说明
content	string	Wiki 页面的内容。
gitItemPath	string	对应于支持 Git 存储库中存储的 Wiki 页面的 git 项的路径。
isNonConformant	boolean	如此 如果页面不符合，即 1） 如果名称与页面命名标准不匹配。 2） 如果页面在适当的顺序文件中没有有效的条目，则为 2。
isParentPage	boolean	如此 如果此页面在其路径下有子页。
order	integer (int32)	Wiki 页面的顺序，相对于同一层次结构级别中的其他页面。
path	string	Wiki 页面的路径。
remoteUrl	string	Wiki 页面的远程 Web URL。
subPages	WikiPage[]	当前页的子页列表。
url	string	此 Wiki 页面的 REST URL。