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

ApiManagementServiceUpdateProperties interface

包:

@azure/arm-apimanagement

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

扩展

ApiManagementServiceBaseProperties

属性

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 之外的所有设置，默认值为 True ：服务是在 2018 False 年 4 月 1 日或之前创建的，否则为 。 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_SHA256false。 true默认值为它们。 注意：由于内部平台组件需要以下密码，因此无法禁用以下密码：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 管理服务的当前预配状态，可以是以下之一：创建/激活/成功/更新/失败/已停止/终止/TerminationFailed/Deleted。 注意：此属性不会被序列化。 它只能由服务器填充。
publicIPAddresses	主要区域中API 管理服务的公共静态负载均衡 IP 地址。 仅适用于基本、标准、高级和独立 SKU。 注意：此属性不会被序列化。 它只能由服务器填充。
publicIpAddressId	基于公共标准 SKU IP V4 的 IP 地址，与区域中虚拟网络部署的服务相关联。 仅支持在 虚拟网络 中部署的开发人员和高级 SKU。
publicNetworkAccess	是否允许此API 管理服务访问公共终结点。 值是可选的，但如果传入，则必须为“Enabled”或“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[]

属性值

AdditionalLocation[]

继承自ApiManagementServiceBaseProperties.additionalLocations

apiVersionConstraint

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

apiVersionConstraint?: ApiVersionConstraint

属性值

ApiVersionConstraint

继承自ApiManagementServiceBaseProperties.apiVersionConstraint

certificates

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

certificates?: CertificateConfiguration[]

属性值

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 之外的所有设置，默认值为 True ：服务是在 2018 False 年 4 月 1 日或之前创建的，否则为 。 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_SHA256false。 true默认值为它们。
注意：由于内部平台组件需要以下密码，因此无法禁用以下密码：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[]

属性值

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[]

属性值

RemotePrivateEndpointConnectionWrapper[]

继承自ApiManagementServiceBaseProperties.privateEndpointConnections

privateIPAddresses

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

privateIPAddresses?: string[]

属性值

string[]

继承自ApiManagementServiceBaseProperties.privateIPAddresses

provisioningState

API 管理服务的当前预配状态，可以是以下之一：创建/激活/成功/更新/失败/已停止/终止/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”。 如果“已禁用”，则专用终结点是独占访问方法。 默认值为“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

属性值

VirtualNetworkConfiguration

继承自ApiManagementServiceBaseProperties.virtualNetworkConfiguration

virtualNetworkType

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

virtualNetworkType?: string

属性值

string

继承自ApiManagementServiceBaseProperties.virtualNetworkType