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

ApiCreateOrUpdateProperties interface

API 创建或更新属性。

扩展

属性

format

要导入 API 的内容的格式。

soapApiType

要创建的 API 的类型。

  • http 创建 REST API
  • soap 创建 SOAP 传递 API
  • websocket 创建 websocket API
  • graphql创建 GraphQL API。
translateRequiredQueryParametersConduct

将所需查询参数转换为模板参数的策略。 默认情况下,值为“template”。 可能的值:“template”、“query”

value

导入 API 时的内容值。

wsdlSelector

将 WSDL 导入限制为文档子集的条件。

继承属性

apiRevision

描述 API 的修订。 如果未提供任何值,则会创建默认修订版 1

apiRevisionDescription

API 修订的说明。

apiType

API 的类型。

apiVersion

指示 API 的版本标识符(如果 API 已版本控制)

apiVersionDescription

API 版本的说明。

apiVersionSet

版本集详细信息

apiVersionSetId

相关 ApiVersionSet 的资源标识符。

authenticationSettings

此 API 中包含的身份验证设置的集合。

contact

API 的联系信息。

description

API 的说明。 可以包含 HTML 格式标记。

displayName

API 名称。 长度必须为 1 到 300 个字符。

isCurrent

指示 API 修订是否为当前 API 修订版。

isOnline

指示是否可通过网关访问 API 修订。 注意:此属性不会序列化。 它只能由服务器填充。

license

API 的许可证信息。

path

相对 URL,用于唯一标识此 API 及其在 API 管理服务实例中的所有资源路径。 可将其追加到在服务实例创建过程中指定的 API 终结点基 URL,构成此 API 的公共 URL。

protocols

说明可在哪些协议上调用此 API 中的操作。

serviceUrl

实现此 API 的后端服务的绝对 URL。 长度不能超过 2000 个字符。

sourceApiId

源 API 的 API 标识符。

subscriptionKeyParameterNames

提供 API 的协议。

subscriptionRequired

指定访问 API 是否需要 API 订阅或产品订阅。

termsOfServiceUrl

指向 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

继承自ApiContractProperties.apiRevision

apiRevisionDescription

API 修订的说明。

apiRevisionDescription?: string

属性值

string

继承自ApiContractProperties.apiRevisionDescription

apiType

API 的类型。

apiType?: string

属性值

string

继承自ApiContractProperties.apiType

apiVersion

指示 API 的版本标识符(如果 API 已版本控制)

apiVersion?: string

属性值

string

继承自ApiContractProperties.apiVersion

apiVersionDescription

API 版本的说明。

apiVersionDescription?: string

属性值

string

继承自ApiContractProperties.apiVersionDescription

apiVersionSet

版本集详细信息

apiVersionSet?: ApiVersionSetContractDetails

属性值

继承自ApiContractProperties.apiVersionSet

apiVersionSetId

相关 ApiVersionSet 的资源标识符。

apiVersionSetId?: string

属性值

string

继承自ApiContractProperties.apiVersionSetId

authenticationSettings

此 API 中包含的身份验证设置的集合。

authenticationSettings?: AuthenticationSettingsContract

属性值

继承自ApiContractProperties.authenticationSettings

contact

API 的联系信息。

contact?: ApiContactInformation

属性值

继承自ApiContractProperties.contact

description

API 的说明。 可以包含 HTML 格式标记。

description?: string

属性值

string

继承自ApiContractProperties.description

displayName

API 名称。 长度必须为 1 到 300 个字符。

displayName?: string

属性值

string

继承自ApiContractProperties.displayName

isCurrent

指示 API 修订是否为当前 API 修订版。

isCurrent?: boolean

属性值

boolean

继承自ApiContractProperties.isCurrent

isOnline

指示是否可通过网关访问 API 修订。 注意:此属性不会序列化。 它只能由服务器填充。

isOnline?: boolean

属性值

boolean

继承自ApiContractProperties.isOnline

license

API 的许可证信息。

license?: ApiLicenseInformation

属性值

继承自ApiContractProperties.license

path

相对 URL,用于唯一标识此 API 及其在 API 管理服务实例中的所有资源路径。 可将其追加到在服务实例创建过程中指定的 API 终结点基 URL,构成此 API 的公共 URL。

path: string

属性值

string

继承自ApiContractProperties.path

protocols

说明可在哪些协议上调用此 API 中的操作。

protocols?: string[]

属性值

string[]

继承自ApiContractProperties.protocols

serviceUrl

实现此 API 的后端服务的绝对 URL。 长度不能超过 2000 个字符。

serviceUrl?: string

属性值

string

继承自ApiContractProperties.serviceUrl

sourceApiId

源 API 的 API 标识符。

sourceApiId?: string

属性值

string

继承自ApiContractProperties.sourceApiId

subscriptionKeyParameterNames

提供 API 的协议。

subscriptionKeyParameterNames?: SubscriptionKeyParameterNamesContract

属性值

继承自ApiContractProperties.subscriptionKeyParameterNames

subscriptionRequired

指定访问 API 是否需要 API 订阅或产品订阅。

subscriptionRequired?: boolean

属性值

boolean

继承自ApiContractProperties.subscriptionRequired

termsOfServiceUrl

指向 API 服务条款的 URL。 必须采用 URL 的格式。

termsOfServiceUrl?: string

属性值

string

继承自ApiContractProperties.termsOfServiceUrl