您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

获取分区重新启动进度Get Partition Restart Progress

获取使用 StartPartitionRestart 启动的 PartitionRestart 操作的进度。Gets the progress of a PartitionRestart operation started using StartPartitionRestart.

获取使用提供的 OperationId 通过 StartPartitionRestart 启动的 PartitionRestart 操作的进度。Gets the progress of a PartitionRestart started with StartPartitionRestart using the provided OperationId.

请求Request

方法Method 请求 URIRequest URI
GETGET /Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/GetRestartProgress?api-version=6.0&OperationId={OperationId}&timeout={timeout}

parametersParameters

名称Name 类型Type 必选Required 位置Location
serviceId 字符串string Yes 路径Path
partitionId 字符串(uuid)string (uuid) Yes 路径Path
api-version 字符串string Yes 查询Query
OperationId 字符串(uuid)string (uuid) Yes 查询Query
timeout 整数 (int64)integer (int64) No 查询Query

serviceId

类型: 字符串Type: string
必需: 是Required: Yes

服务的标识。The identity of the service. 此 ID 通常是没有"结构:"URI 方案的服务的全名。This ID is typically the full name of the service without the 'fabric:' URI scheme. 从版本 6.0 开始,分层名称以“~”字符隔开。Starting from version 6.0, hierarchical names are delimited with the "~" character. 例如,如果服务名称为“fabric:/myapp/app1/svc1”,则 6.0 及更高版本中的服务标识为“myapp~app1~svc1”,在以前的版本中为“myapp/app1/svc1”。For example, if the service name is "fabric:/myapp/app1/svc1", the service identity would be "myapp~app1~svc1" in 6.0+ and "myapp/app1/svc1" in previous versions.


partitionId

类型: 字符串 (uuid)Type: string (uuid)
必需: 是Required: Yes

分区的标识。The identity of the partition.


api-version

类型: 字符串Type: string
必需: 是Required: Yes
默认值6.0Default: 6.0

API 的版本。The version of the API. 此参数是必需的,其值必须为"6.0"。This parameter is required and its value must be '6.0'.

服务结构 REST API 版本基于引入或更改 API 的运行时版本。Service Fabric REST API version is based on the runtime version in which the API was introduced or was changed. 服务结构运行时支持多个版本的 API。Service Fabric runtime supports more than one version of the API. 这是 API 支持的最新版本。This is the latest supported version of the API. 如果传递了较低的 API 版本,则返回的响应可能与本规范中记录的响应不同。If a lower API version is passed, the returned response may be different from the one documented in this specification.

此外,运行时接受任何版本高于当前受支持的版本,以连接到运行时的当前版本。Additionally the runtime accept any version that is higher than the latest supported version up to the current version of the runtime. 因此,如果最新的 API 版本为 6.0,但如果运行时为 6.1,为了更轻松地编写客户端,运行时将接受该 API 的版本 6.1。So if the latest API version is 6.0, but if the runtime is 6.1, in order to make it easier to write the clients, the runtime will accept version 6.1 for that API. 但是,API 的行为将按文档记录的 6.0 版本进行。However the behavior of the API will be as per the documented 6.0 version.


OperationId

类型: 字符串 (uuid)Type: string (uuid)
必需: 是Required: Yes

用于标识此 API 的调用的 GUID。A GUID that identifies a call of this API. 这将传递到相应的 GetProgress API 中This is passed into the corresponding GetProgress API


timeout

类型: 整数 (int64)Type: integer (int64)
必需: 否Required: No
默认值60Default: 60
包含最大值4294967295InclusiveMaximum: 4294967295
包含最小 :1InclusiveMinimum: 1

执行操作的服务器超时,以秒为单位。The server timeout for performing the operation in seconds. 此超时指定客户端可以等待请求的操作完成的持续时间。This timeout specifies the time duration that the client is willing to wait for the requested operation to complete. 此参数的默认值为 60 秒。The default value for this parameter is 60 seconds.

响应Responses

HTTP 状态代码HTTP Status Code 说明Description 响应架构Response Schema
200 (正常)200 (OK) 有关分区重新启动操作进度的信息。Information about the progress of a partition restart operation.
分区重新启动进度PartitionRestartProgress
所有其他状态代码All other status codes 详细的错误响应。The detailed error response.
结构错误FabricError

示例Examples

获取信息已完成的分区重新启动操作Get information a completed PartitionRestart operation

这显示了 GetPartitionRestartProgress 已达到"已完成状态"时可能输出的示例。This shows an example of possible output when GetPartitionRestartProgress has reached a State of Completed. 如果国家具有"正在运行"的值,则只有"状态"字段具有值。If the State has a value of Running, only the State field will have a value.

请求Request

GET http://localhost:19080/Faults/Services/fabric:/myapp/myservice/$/GetPartitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/GetRestartProgress?api-version=6.0&OperationId=6eb7f0d3-49ca-4cb1-81b7-ac2d56b5c5d1

200 响应200 Response

BodyBody
{
  "State": "Completed",
  "RestartPartitionResult": {
    "ErrorCode": "0",
    "SelectedPartition": {
      "ServiceName": "fabric:/myapp/myservice",
      "PartitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
    }
  }
}