你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
ApiCreateOrUpdateProperties interface
API 创建或更新属性。
- 扩展
属性
format | 要导入 API 的内容的格式。 |
soap |
要创建的 API 的类型。
|
translate |
将所需查询参数转换为模板参数的策略。 默认情况下,值为“template”。 可能的值:“template”、“query” |
value | 导入 API 时的内容值。 |
wsdl |
将 WSDL 导入限制为文档子集的条件。 |
继承属性
api |
描述 API 的修订。 如果未提供任何值,则会创建默认修订版 1 |
api |
API 修订的说明。 |
api |
API 的类型。 |
api |
指示 API 的版本标识符(如果 API 已版本控制) |
api |
API 版本的说明。 |
api |
版本集详细信息 |
api |
相关 ApiVersionSet 的资源标识符。 |
authentication |
此 API 中包含的身份验证设置的集合。 |
contact | API 的联系信息。 |
description | API 的说明。 可以包含 HTML 格式标记。 |
display |
API 名称。 长度必须为 1 到 300 个字符。 |
is |
指示 API 修订是否为当前 API 修订版。 |
is |
指示是否可通过网关访问 API 修订。 注意:此属性不会序列化。 它只能由服务器填充。 |
license | API 的许可证信息。 |
path | 相对 URL,用于唯一标识此 API 及其在 API 管理服务实例中的所有资源路径。 可将其追加到在服务实例创建过程中指定的 API 终结点基 URL,构成此 API 的公共 URL。 |
protocols | 说明可在哪些协议上调用此 API 中的操作。 |
service |
实现此 API 的后端服务的绝对 URL。 长度不能超过 2000 个字符。 |
source |
源 API 的 API 标识符。 |
subscription |
提供 API 的协议。 |
subscription |
指定访问 API 是否需要 API 订阅或产品订阅。 |
terms |
指向 API 服务条款的 URL。 必须采用 URL 的格式。 |
属性详细信息
format
要导入 API 的内容的格式。
format?: string
属性值
string
soapApiType
要创建的 API 的类型。
-
http
创建 REST API -
soap
创建 SOAP 传递 API -
websocket
创建 websocket API -
graphql
创建 GraphQL API。
soapApiType?: string
属性值
string
translateRequiredQueryParametersConduct
将所需查询参数转换为模板参数的策略。 默认情况下,值为“template”。 可能的值:“template”、“query”
translateRequiredQueryParametersConduct?: string
属性值
string
value
导入 API 时的内容值。
value?: string
属性值
string
wsdlSelector
将 WSDL 导入限制为文档子集的条件。
wsdlSelector?: ApiCreateOrUpdatePropertiesWsdlSelector
属性值
继承属性详细信息
apiRevision
描述 API 的修订。 如果未提供任何值,则会创建默认修订版 1
apiRevision?: string
属性值
string
apiRevisionDescription
API 修订的说明。
apiRevisionDescription?: string
属性值
string
apiType
apiVersion
apiVersionDescription
apiVersionSet
版本集详细信息
apiVersionSet?: ApiVersionSetContractDetails
属性值
apiVersionSetId
相关 ApiVersionSet 的资源标识符。
apiVersionSetId?: string
属性值
string
authenticationSettings
此 API 中包含的身份验证设置的集合。
authenticationSettings?: AuthenticationSettingsContract
属性值
contact
API 的联系信息。
contact?: ApiContactInformation
属性值
description
displayName
isCurrent
isOnline
指示是否可通过网关访问 API 修订。 注意:此属性不会序列化。 它只能由服务器填充。
isOnline?: boolean
属性值
boolean
license
API 的许可证信息。
license?: ApiLicenseInformation
属性值
path
相对 URL,用于唯一标识此 API 及其在 API 管理服务实例中的所有资源路径。 可将其追加到在服务实例创建过程中指定的 API 终结点基 URL,构成此 API 的公共 URL。
path: string
属性值
string
protocols
serviceUrl
实现此 API 的后端服务的绝对 URL。 长度不能超过 2000 个字符。
serviceUrl?: string
属性值
string
sourceApiId
subscriptionKeyParameterNames
提供 API 的协议。
subscriptionKeyParameterNames?: SubscriptionKeyParameterNamesContract
属性值
subscriptionRequired
指定访问 API 是否需要 API 订阅或产品订阅。
subscriptionRequired?: boolean
属性值
boolean
termsOfServiceUrl
指向 API 服务条款的 URL。 必须采用 URL 的格式。
termsOfServiceUrl?: string
属性值
string