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

ApiManagementServiceProperties interface

API 管理服务资源说明的属性。

扩展

属性

publisherEmail

发布者电子邮件。

publisherName

发布者名称。

继承属性

additionalLocations

API 管理服务的其他数据中心位置。

apiVersionConstraint

API 管理服务的控制平面 Api 版本约束。

certificates

需要在 API 管理 服务中安装的证书列表。 可安装的最大支持证书数为 10。

createdAtUtc

API 管理服务的创建 UTC 日期。日期符合以下格式:yyyy-MM-ddTHH:mm:ssZ由 ISO 8601 标准指定。 注意:此属性不会序列化。 它只能由服务器填充。

customProperties

API 管理服务的自定义属性。
设置Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168将禁用所有 TLS (1.0、1.1 和 1.2) 的密码TLS_RSA_WITH_3DES_EDE_CBC_SHA。
设置Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11可用于仅禁用 TLS 1.1。
设置Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10可用于在API 管理服务上禁用 TLS 1.0。
设置Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11可用于仅禁用与后端通信的 TLS 1.1。
设置Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10可用于禁用 TLS 1.0 与后端的通信。
设置Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2可用于在API 管理服务上启用 HTTP2 协议。
如果不在 PATCH 操作上指定任何这些属性,则会将省略的属性的值重置为默认值。 对于除 Http2 之外的所有设置,如果服务是在 2018 False 年 4 月 1 日或之前创建的,则默认值为 True ,否则为 。 Http2 设置的默认值为 False

可以使用设置 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.[cipher_name]禁用以下任何密码:TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA、TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA、TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA、TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA、TLS_RSA_WITH_AES_128_GCM_SHA256、TLS_RSA_WITH_AES_256_CBC_SHA256、 TLS_RSA_WITH_AES_128_CBC_SHA256、TLS_RSA_WITH_AES_256_CBC_SHA、TLS_RSA_WITH_AES_128_CBC_SHA。 例如:Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_CBC_SHA256falsetrue默认值为 。
注意:由于内部平台组件需要以下密码,因此无法禁用以下密码:TLS_AES_256_GCM_SHA384、TLS_AES_128_GCM_SHA256、TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384、TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256、TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384、TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256、TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

developerPortalUrl

API 管理服务的 DEveloper 门户终结点 URL。 注意:此属性不会序列化。 它只能由服务器填充。

disableGateway

属性仅对部署在多个位置的 Api 管理服务有效。 这可用于禁用主区域中的网关。

enableClientCertificate

属性仅用于消耗 SKU 服务。 这会强制在向网关发出每个请求时提供客户端证书。 这还允许在网关上的策略中对证书进行身份验证。

gatewayRegionalUrl

默认区域中API 管理服务的网关 URL。 注意:此属性不会序列化。 它只能由服务器填充。

gatewayUrl

API 管理服务的网关 URL。 注意:此属性不会序列化。 它只能由服务器填充。

hostnameConfigurations

API 管理服务的自定义主机名配置。

managementApiUrl

API 管理服务的管理 API 终结点 URL。 注意:此属性不会序列化。 它只能由服务器填充。

natGatewayState

属性可用于为此API 管理服务启用 NAT 网关。

notificationSenderEmail

Email发送通知的地址。

outboundPublicIPAddresses

与 NAT 网关部署的服务关联的出站公共 IPV4 地址前缀。 仅适用于 stv2 平台上的高级 SKU。 注意:此属性不会序列化。 它只能由服务器填充。

platformVersion

在此位置运行服务的计算平台版本。 注意:此属性不会序列化。 它只能由服务器填充。

portalUrl

API 管理服务的发布者门户终结点 URL。 注意:此属性不会序列化。 它只能由服务器填充。

privateEndpointConnections

此服务的专用终结点连接列表。

privateIPAddresses

主要区域中部署在内部虚拟网络中的 API 管理 服务的专用静态负载均衡 IP 地址。 仅适用于基本、标准、高级和独立 SKU。 注意:此属性不会序列化。 它只能由服务器填充。

provisioningState

API 管理服务的当前预配状态,可以是以下项之一:Created/Activating/Succeeded/Updating/Failed/Stopped/Terminating/TerminationFailed/Deleted。 注意:此属性不会序列化。 它只能由服务器填充。

publicIPAddresses

主要区域中API 管理服务的公共静态负载均衡 IP 地址。 仅适用于基本、标准、高级和独立 SKU。 注意:此属性不会序列化。 它只能由服务器填充。

publicIpAddressId

要与区域中部署的服务关联的基于公共标准 SKU IP V4 的 IP 地址虚拟网络。 仅支持在 虚拟网络 中部署的开发人员和高级 SKU。

publicNetworkAccess

此API 管理服务是否允许公共终结点访问。 值是可选的,但如果传入,则必须为“Enabled”或“Disabled”。 如果为“Disabled”,则专用终结点是独占访问方法。 默认值为“Enabled”

restore

取消删除 Api 管理服务(如果以前已软删除)。 如果指定了此标志并将其设置为 True,则将忽略所有其他属性。

scmUrl

API 管理服务的 SCM 终结点 URL。 注意:此属性不会序列化。 它只能由服务器填充。

targetProvisioningState

API 管理服务的预配状态,这是针对该服务启动的长时间运行操作的目标。 注意:此属性不会序列化。 它只能由服务器填充。

virtualNetworkConfiguration

API 管理服务的虚拟网络配置。

virtualNetworkType

需要在其中配置API 管理服务的 VPN 类型。 无 (默认值) 表示API 管理服务不属于任何虚拟网络,外部表示API 管理部署是在具有面向 Internet 的终结点的虚拟网络内设置的,而“内部”表示API 管理部署是在仅具有面向 Intranet 的终结点的虚拟网络内设置的.

属性详细信息

publisherEmail

发布者电子邮件。

publisherEmail: string

属性值

string

publisherName

发布者名称。

publisherName: string

属性值

string

继承属性详细信息

additionalLocations

API 管理服务的其他数据中心位置。

additionalLocations?: AdditionalLocation[]

属性值

继承自ApiManagementServiceBaseProperties.additionalLocations

apiVersionConstraint

API 管理服务的控制平面 Api 版本约束。

apiVersionConstraint?: ApiVersionConstraint

属性值

继承自ApiManagementServiceBaseProperties.apiVersionConstraint

certificates

需要在 API 管理 服务中安装的证书列表。 可安装的最大支持证书数为 10。

certificates?: CertificateConfiguration[]

属性值

继承自ApiManagementServiceBaseProperties.certificates

createdAtUtc

API 管理服务的创建 UTC 日期。日期符合以下格式:yyyy-MM-ddTHH:mm:ssZ由 ISO 8601 标准指定。 注意:此属性不会序列化。 它只能由服务器填充。

createdAtUtc?: Date

属性值

Date

继承自ApiManagementServiceBaseProperties.createdAtUtc

customProperties

API 管理服务的自定义属性。
设置Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168将禁用所有 TLS (1.0、1.1 和 1.2) 的密码TLS_RSA_WITH_3DES_EDE_CBC_SHA。
设置Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11可用于仅禁用 TLS 1.1。
设置Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10可用于在API 管理服务上禁用 TLS 1.0。
设置Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11可用于仅禁用与后端通信的 TLS 1.1。
设置Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10可用于禁用 TLS 1.0 与后端的通信。
设置Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2可用于在API 管理服务上启用 HTTP2 协议。
如果不在 PATCH 操作上指定任何这些属性,则会将省略的属性的值重置为默认值。 对于除 Http2 之外的所有设置,如果服务是在 2018 False 年 4 月 1 日或之前创建的,则默认值为 True ,否则为 。 Http2 设置的默认值为 False

可以使用设置 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.[cipher_name]禁用以下任何密码:TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA、TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA、TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA、TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA、TLS_RSA_WITH_AES_128_GCM_SHA256、TLS_RSA_WITH_AES_256_CBC_SHA256、 TLS_RSA_WITH_AES_128_CBC_SHA256、TLS_RSA_WITH_AES_256_CBC_SHA、TLS_RSA_WITH_AES_128_CBC_SHA。 例如:Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_CBC_SHA256falsetrue默认值为 。
注意:由于内部平台组件需要以下密码,因此无法禁用以下密码:TLS_AES_256_GCM_SHA384、TLS_AES_128_GCM_SHA256、TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384、TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256、TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384、TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256、TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

customProperties?: {[propertyName: string]: string}

属性值

{[propertyName: string]: string}

继承自ApiManagementServiceBaseProperties.customProperties

developerPortalUrl

API 管理服务的 DEveloper 门户终结点 URL。 注意:此属性不会序列化。 它只能由服务器填充。

developerPortalUrl?: string

属性值

string

继承自ApiManagementServiceBaseProperties.developerPortalUrl

disableGateway

属性仅对部署在多个位置的 Api 管理服务有效。 这可用于禁用主区域中的网关。

disableGateway?: boolean

属性值

boolean

继承自ApiManagementServiceBaseProperties.disableGateway

enableClientCertificate

属性仅用于消耗 SKU 服务。 这会强制在向网关发出每个请求时提供客户端证书。 这还允许在网关上的策略中对证书进行身份验证。

enableClientCertificate?: boolean

属性值

boolean

继承自ApiManagementServiceBaseProperties.enableClientCertificate

gatewayRegionalUrl

默认区域中API 管理服务的网关 URL。 注意:此属性不会序列化。 它只能由服务器填充。

gatewayRegionalUrl?: string

属性值

string

继承自ApiManagementServiceBaseProperties.gatewayRegionalUrl

gatewayUrl

API 管理服务的网关 URL。 注意:此属性不会序列化。 它只能由服务器填充。

gatewayUrl?: string

属性值

string

继承自ApiManagementServiceBaseProperties.gatewayUrl

hostnameConfigurations

API 管理服务的自定义主机名配置。

hostnameConfigurations?: HostnameConfiguration[]

属性值

继承自ApiManagementServiceBaseProperties.hostnameConfigurations

managementApiUrl

API 管理服务的管理 API 终结点 URL。 注意:此属性不会序列化。 它只能由服务器填充。

managementApiUrl?: string

属性值

string

继承自ApiManagementServiceBaseProperties.managementApiUrl

natGatewayState

属性可用于为此API 管理服务启用 NAT 网关。

natGatewayState?: string

属性值

string

继承自ApiManagementServiceBaseProperties.natGatewayState

notificationSenderEmail

Email发送通知的地址。

notificationSenderEmail?: string

属性值

string

继承自ApiManagementServiceBaseProperties.notificationSenderEmail

outboundPublicIPAddresses

与 NAT 网关部署的服务关联的出站公共 IPV4 地址前缀。 仅适用于 stv2 平台上的高级 SKU。 注意:此属性不会序列化。 它只能由服务器填充。

outboundPublicIPAddresses?: string[]

属性值

string[]

继承自ApiManagementServiceBaseProperties.outboundPublicIPAddresses

platformVersion

在此位置运行服务的计算平台版本。 注意:此属性不会序列化。 它只能由服务器填充。

platformVersion?: string

属性值

string

继承自ApiManagementServiceBaseProperties.platformVersion

portalUrl

API 管理服务的发布者门户终结点 URL。 注意:此属性不会序列化。 它只能由服务器填充。

portalUrl?: string

属性值

string

继承自ApiManagementServiceBaseProperties.portalUrl

privateEndpointConnections

此服务的专用终结点连接列表。

privateEndpointConnections?: RemotePrivateEndpointConnectionWrapper[]

属性值

继承自ApiManagementServiceBaseProperties.privateEndpointConnections

privateIPAddresses

主要区域中部署在内部虚拟网络中的 API 管理 服务的专用静态负载均衡 IP 地址。 仅适用于基本、标准、高级和独立 SKU。 注意:此属性不会序列化。 它只能由服务器填充。

privateIPAddresses?: string[]

属性值

string[]

继承自ApiManagementServiceBaseProperties.privateIPAddresses

provisioningState

API 管理服务的当前预配状态,可以是以下项之一:Created/Activating/Succeeded/Updating/Failed/Stopped/Terminating/TerminationFailed/Deleted。 注意:此属性不会序列化。 它只能由服务器填充。

provisioningState?: string

属性值

string

继承自ApiManagementServiceBaseProperties.provisioningState

publicIPAddresses

主要区域中API 管理服务的公共静态负载均衡 IP 地址。 仅适用于基本、标准、高级和独立 SKU。 注意:此属性不会序列化。 它只能由服务器填充。

publicIPAddresses?: string[]

属性值

string[]

继承自ApiManagementServiceBaseProperties.publicIPAddresses

publicIpAddressId

要与区域中部署的服务关联的基于公共标准 SKU IP V4 的 IP 地址虚拟网络。 仅支持在 虚拟网络 中部署的开发人员和高级 SKU。

publicIpAddressId?: string

属性值

string

继承自ApiManagementServiceBaseProperties.publicIpAddressId

publicNetworkAccess

此API 管理服务是否允许公共终结点访问。 值是可选的,但如果传入,则必须为“Enabled”或“Disabled”。 如果为“Disabled”,则专用终结点是独占访问方法。 默认值为“Enabled”

publicNetworkAccess?: string

属性值

string

继承自ApiManagementServiceBaseProperties.publicNetworkAccess

restore

取消删除 Api 管理服务(如果以前已软删除)。 如果指定了此标志并将其设置为 True,则将忽略所有其他属性。

restore?: boolean

属性值

boolean

继承自ApiManagementServiceBaseProperties.restore

scmUrl

API 管理服务的 SCM 终结点 URL。 注意:此属性不会序列化。 它只能由服务器填充。

scmUrl?: string

属性值

string

继承自ApiManagementServiceBaseProperties.scmUrl

targetProvisioningState

API 管理服务的预配状态,这是针对该服务启动的长时间运行操作的目标。 注意:此属性不会序列化。 它只能由服务器填充。

targetProvisioningState?: string

属性值

string

继承自ApiManagementServiceBaseProperties.targetProvisioningState

virtualNetworkConfiguration

API 管理服务的虚拟网络配置。

virtualNetworkConfiguration?: VirtualNetworkConfiguration

属性值

继承自ApiManagementServiceBaseProperties.virtualNetworkConfiguration

virtualNetworkType

需要在其中配置API 管理服务的 VPN 类型。 无 (默认值) 表示API 管理服务不属于任何虚拟网络,外部表示API 管理部署是在具有面向 Internet 的终结点的虚拟网络内设置的,而“内部”表示API 管理部署是在仅具有面向 Intranet 的终结点的虚拟网络内设置的.

virtualNetworkType?: string

属性值

string

继承自ApiManagementServiceBaseProperties.virtualNetworkType