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

ApiCreateOrUpdateParameter interface

API 创建或更新参数。

属性

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 个字符。

format

要导入 API 的内容的格式。

isCurrent

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

isOnline

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

license

API 的许可证信息。

path

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

protocols

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

serviceUrl

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

soapApiType

要创建的 API 的类型。

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

源 API 的 API 标识符。

subscriptionKeyParameterNames

提供 API 的协议。

subscriptionRequired

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

termsOfServiceUrl

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

translateRequiredQueryParametersConduct

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

value

导入 API 时的内容值。

wsdlSelector

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

属性详细信息

apiRevision

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

apiRevision?: string

属性值

string

apiRevisionDescription

API 修订版的说明。

apiRevisionDescription?: string

属性值

string

apiType

API 的类型。

apiType?: string

属性值

string

apiVersion

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

apiVersion?: string

属性值

string

apiVersionDescription

API 版本的说明。

apiVersionDescription?: string

属性值

string

apiVersionSet

版本集详细信息

apiVersionSet?: ApiVersionSetContractDetails

属性值

apiVersionSetId

相关 ApiVersionSet 的资源标识符。

apiVersionSetId?: string

属性值

string

authenticationSettings

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

authenticationSettings?: AuthenticationSettingsContract

属性值

contact

API 的联系信息。

contact?: ApiContactInformation

属性值

description

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

description?: string

属性值

string

displayName

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

displayName?: string

属性值

string

format

要导入 API 的内容的格式。

format?: string

属性值

string

isCurrent

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

isCurrent?: boolean

属性值

boolean

isOnline

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

isOnline?: boolean

属性值

boolean

license

API 的许可证信息。

license?: ApiLicenseInformation

属性值

path

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

path?: string

属性值

string

protocols

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

protocols?: string[]

属性值

string[]

serviceUrl

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

serviceUrl?: string

属性值

string

soapApiType

要创建的 API 的类型。

  • http 创建 REST API
  • soap 创建 SOAP 传递 API
  • websocket 创建 websocket API
  • graphql创建 GraphQL API。
soapApiType?: string

属性值

string

sourceApiId

源 API 的 API 标识符。

sourceApiId?: string

属性值

string

subscriptionKeyParameterNames

提供 API 的协议。

subscriptionKeyParameterNames?: SubscriptionKeyParameterNamesContract

属性值

subscriptionRequired

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

subscriptionRequired?: boolean

属性值

boolean

termsOfServiceUrl

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

termsOfServiceUrl?: string

属性值

string

translateRequiredQueryParametersConduct

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

translateRequiredQueryParametersConduct?: string

属性值

string

value

导入 API 时的内容值。

value?: string

属性值

string

wsdlSelector

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

wsdlSelector?: ApiCreateOrUpdatePropertiesWsdlSelector

属性值