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

Services - Update

用于更新正在退出的服务的操作。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}?api-version=2023-12-01

URI 参数

名称 必需 类型 说明
resourceGroupName
path True

string

包含该资源的资源组名称。 可以从 Azure 资源管理器 API 或门户获取此值。

serviceName
path True

string

服务资源的名称。

正则表达式模式: ^[a-z][a-z0-9-]*[a-z0-9]$

subscriptionId
path True

string

获取唯一标识 Microsoft Azure 订阅的订阅 ID。 此订阅 ID 是每个服务调用的 URI 的一部分。

api-version
query True

string

要用于此操作的 API 版本。

请求正文

名称 类型 说明
location

string

资源的地理位置。

properties

ClusterResourceProperties

服务资源的属性

sku

Sku

服务资源的 SKU

tags

object

服务的标记,它是描述资源的键值对的列表。

响应

名称 类型 说明
200 OK

ServiceResource

成功。 响应描述更新的服务。

202 Accepted

ServiceResource

已接受。 响应指示正在退出的服务正在更新,并包含用于查询操作结果的 Location 标头。

Other Status Codes

CloudError

描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

Services_Update

示例请求

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.AppPlatform/Spring/myservice?api-version=2023-12-01

{
  "properties": {},
  "sku": {
    "name": "S0",
    "tier": "Standard"
  },
  "location": "eastus",
  "tags": {
    "key1": "value1"
  }
}

示例响应

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.AppPlatform/locations/eastus/operationStatus/myservice/operationId/00000000-0000-0000-0000-000000000000?api-version=2023-12-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.AppPlatform/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000/Spring/myservice?api-version=2023-12-01
{
  "properties": {
    "provisioningState": "Updating",
    "serviceId": "12345678abcd1234abcd12345678abcd",
    "networkProfile": {
      "outboundIPs": {
        "publicIPs": [
          "20.39.3.173",
          "40.64.67.13"
        ]
      },
      "ingressConfig": {
        "readTimeoutInSeconds": 300
      },
      "requiredTraffics": [
        {
          "protocol": "TCP",
          "port": 443,
          "ips": [
            "20.62.211.25",
            "52.188.47.226"
          ],
          "direction": "Outbound"
        },
        {
          "protocol": "UDP",
          "port": 1194,
          "ips": [
            "20.62.211.25",
            "52.188.47.226"
          ],
          "direction": "Outbound"
        },
        {
          "protocol": "TCP",
          "port": 9000,
          "ips": [
            "20.62.211.25",
            "52.188.47.226"
          ],
          "direction": "Outbound"
        }
      ]
    }
  },
  "systemData": {
    "createdBy": "sample-user",
    "createdByType": "User",
    "createdAt": "2021-08-11T03:16:03.944Z",
    "lastModifiedBy": "sample-user",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-08-11T03:17:03.944Z"
  },
  "type": "Microsoft.AppPlatform/Spring",
  "sku": {
    "name": "S0",
    "tier": "Standard"
  },
  "location": "eastus",
  "tags": {
    "key1": "value1"
  },
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.AppPlatform/Spring/myservice",
  "name": "myservice"
}
{
  "properties": {
    "provisioningState": "Succeeded",
    "serviceId": "12345678abcd1234abcd12345678abcd",
    "networkProfile": {
      "outboundIPs": {
        "publicIPs": [
          "20.39.3.173",
          "40.64.67.13"
        ]
      },
      "requiredTraffics": [
        {
          "protocol": "TCP",
          "port": 443,
          "ips": [
            "20.62.211.25",
            "52.188.47.226"
          ],
          "direction": "Outbound"
        },
        {
          "protocol": "UDP",
          "port": 1194,
          "ips": [
            "20.62.211.25",
            "52.188.47.226"
          ],
          "direction": "Outbound"
        },
        {
          "protocol": "TCP",
          "port": 9000,
          "ips": [
            "20.62.211.25",
            "52.188.47.226"
          ],
          "direction": "Outbound"
        }
      ]
    }
  },
  "systemData": {
    "createdBy": "sample-user",
    "createdByType": "User",
    "createdAt": "2021-08-11T03:16:03.944Z",
    "lastModifiedBy": "sample-user",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-08-11T03:17:03.944Z"
  },
  "type": "Microsoft.AppPlatform/Spring",
  "sku": {
    "name": "S0",
    "tier": "Standard"
  },
  "location": "eastus",
  "tags": {
    "key1": "value1"
  },
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.AppPlatform/Spring/myservice",
  "name": "myservice"
}

定义

名称 说明
CloudError

来自服务的错误响应。

CloudErrorBody

来自服务的错误响应。

ClusterResourceProperties

服务属性有效负载

createdByType

创建资源的标识类型。

IngressConfig

Azure Spring Apps 资源的入口配置有效负载。

lastModifiedByType

上次修改资源的标识类型。

MarketplaceResource

为一个 Azure Spring Apps 实例购买第三方产品

NetworkProfile

服务网络配置文件有效负载

OutboundIPs

Azure Spring Apps 资源所需的出站 IP 资源。

PowerState

服务的电源状态

ProvisioningState

服务的预配状态

RequiredTraffic

Azure Spring Apps 资源所需的入站或出站流量。

ServiceResource

服务资源

ServiceVNetAddons

vnet 注入实例中的其他服务设置

Sku

Azure Spring Apps 的 SKU

SystemData

与资源的创建和上次修改相关的元数据。

trafficDirection

所需流量的方向

CloudError

来自服务的错误响应。

名称 类型 说明
error

CloudErrorBody

来自服务的错误响应。

CloudErrorBody

来自服务的错误响应。

名称 类型 说明
code

string

错误的标识符。 代码是固定的,旨在以编程方式使用。

details

CloudErrorBody[]

有关错误的其他详细信息的列表。

message

string

描述错误的消息,该消息适用于在用户界面中显示。

target

string

特定错误的目标。 例如,属性的名称出错。

ClusterResourceProperties

服务属性有效负载

名称 类型 默认值 说明
fqdn

string

服务实例的完全限定 DNS 名称

marketplaceResource

MarketplaceResource

购买服务资源的第三方产品。

networkProfile

NetworkProfile

服务的网络配置文件

powerState

PowerState

服务的电源状态

provisioningState

ProvisioningState

服务的预配状态

serviceId

string

唯一标识已创建资源的 ServiceInstanceEntity ID

version

integer

服务版本

vnetAddons

ServiceVNetAddons

vnet 注入实例中的其他服务设置

zoneRedundant

boolean

False

createdByType

创建资源的标识类型。

名称 类型 说明
Application

string

Key

string

ManagedIdentity

string

User

string

IngressConfig

Azure Spring Apps 资源的入口配置有效负载。

名称 类型 说明
readTimeoutInSeconds

integer

入口读取超时(以秒为单位)。

lastModifiedByType

上次修改资源的标识类型。

名称 类型 说明
Application

string

Key

string

ManagedIdentity

string

User

string

MarketplaceResource

为一个 Azure Spring Apps 实例购买第三方产品

名称 类型 说明
plan

string

正在采购的第三方项目的计划 ID。

product

string

正在采购的第三方项目。

publisher

string

正在购买的第三方项目的发布者 ID。

NetworkProfile

服务网络配置文件有效负载

名称 类型 说明
appNetworkResourceGroup

string

包含 Azure Spring Apps 中客户应用的网络资源的资源组的名称

appSubnetId

string

用于在 Azure Spring Apps 中托管客户应用的子网的完全限定资源 ID

ingressConfig

IngressConfig

Azure Spring Apps 资源的入口配置有效负载。

outboundIPs

OutboundIPs

Azure Spring Apps 资源所需的出站 IP 资源。

outboundType

string

Azure Spring Apps VNet 实例的出口流量类型。

requiredTraffics

RequiredTraffic[]

Azure Spring Apps 资源所需的入站或出站流量。

serviceCidr

string

Azure Spring Apps 服务保留 CIDR

serviceRuntimeNetworkResourceGroup

string

包含 Azure Spring Apps 服务运行时网络资源的资源组的名称

serviceRuntimeSubnetId

string

用于托管 Azure Spring Apps 服务运行时的子网的完全限定资源 ID

OutboundIPs

Azure Spring Apps 资源所需的出站 IP 资源。

名称 类型 说明
publicIPs

string[]

公共 IP 地址的列表。

PowerState

服务的电源状态

名称 类型 说明
Running

string

Stopped

string

ProvisioningState

服务的预配状态

名称 类型 说明
Creating

string

Deleted

string

Deleting

string

Failed

string

MoveFailed

string

Moved

string

Moving

string

Starting

string

Stopping

string

Succeeded

string

Updating

string

RequiredTraffic

Azure Spring Apps 资源所需的入站或出站流量。

名称 类型 说明
direction

trafficDirection

所需流量的方向

fqdns

string[]

所需流量的 FQDN 列表

ips

string[]

所需流量的 IP 列表

port

integer

所需流量的端口

protocol

string

所需流量的协议

ServiceResource

服务资源

名称 类型 说明
id

string

资源的完全限定资源 ID。

location

string

资源的地理位置。

name

string

资源的名称。

properties

ClusterResourceProperties

服务资源的属性

sku

Sku

服务资源的 SKU

systemData

SystemData

与资源的创建和上次修改相关的元数据。

tags

object

服务的标记,它是描述资源的键值对的列表。

type

string

资源类型。

ServiceVNetAddons

vnet 注入实例中的其他服务设置

名称 类型 默认值 说明
dataPlanePublicEndpoint

boolean

False

指示是否可以从 Internet 访问 vnet 注入实例中的数据平面组件 (日志流、应用连接、远程调试) 。

logStreamPublicEndpoint

boolean

False

指示是否可以从 Internet 访问 vnet 注入实例中的日志流。

Sku

Azure Spring Apps 的 SKU

名称 类型 默认值 说明
capacity

integer

目标资源的当前容量

name

string

S0

SKU 的名称

tier

string

Standard

SKU 的层

SystemData

与资源的创建和上次修改相关的元数据。

名称 类型 说明
createdAt

string

资源创建时间戳 (UTC) 。

createdBy

string

创建资源的标识。

createdByType

createdByType

创建资源的标识类型。

lastModifiedAt

string

资源修改的时间戳 (UTC) 。

lastModifiedBy

string

上次修改资源的标识。

lastModifiedByType

lastModifiedByType

上次修改资源的标识类型。

trafficDirection

所需流量的方向

名称 类型 说明
Inbound

string

Outbound

string