Resolver servicio
Resuelve una partición de Service Fabric.
Resuelve una partición de servicio de Service Fabric para obtener los puntos de conexión de las réplicas de servicio.
Solicitud
| Método | URI de solicitud |
|---|---|
| GET | /Services/{serviceId}/$/ResolvePartition?api-version=6.0&PartitionKeyType={PartitionKeyType}&PartitionKeyValue={PartitionKeyValue}&PreviousRspVersion={PreviousRspVersion}&timeout={timeout} |
Parámetros
| Nombre | Tipo | Requerido | Location |
|---|---|---|---|
serviceId |
string | Sí | Ruta de acceso |
api-version |
string | Sí | Consultar |
PartitionKeyType |
integer | No | Consultar |
PartitionKeyValue |
string | No | Consultar |
PreviousRspVersion |
string | No | Consultar |
timeout |
entero (int64) | No | Consultar |
serviceId
Tipo: cadena
Obligatoria: sí
La identidad del servicio. Este identificador suele ser el nombre completo del servicio sin el esquema de URI "fabric:".
A partir de la versión 6.0, los nombres jerárquicos se delimitan con el carácter "~".
Por ejemplo, si el nombre del servicio es "fabric:/myapp/app1/svc1", la identidad de servicio sería "myapp~app1~svc1" en 6.0+ y "myapp/app1/svc1" en las versiones anteriores.
api-version
Tipo: cadena
Obligatoria: sí
Predeterminado:
La versión de la API. Este parámetro es necesario y su valor debe ser "6.0".
La versión de la API rest de Service Fabric se basa en la versión en tiempo de ejecución en la que se introdujo o se cambió la API. El entorno de ejecución de Service Fabric admite más de una versión de la API. Esta es la versión compatible más reciente de la API. Si se pasa una versión de API inferior, la respuesta devuelta puede ser diferente de la documentada en esta especificación.
Además, el tiempo de ejecución acepta cualquier versión superior a la versión admitida más reciente hasta la versión actual del entorno de ejecución. Por lo tanto, si la versión más reciente de la API es 6.0, pero si el runtime es 6.1, para facilitar la escritura de los clientes, el entorno de ejecución aceptará la versión 6.1 para esa API. Sin embargo, el comportamiento de la API será según la versión 6.0 documentada.
PartitionKeyType
Tipo: entero
Obligatoria: no
Tipo de clave para la partición. Este parámetro es obligatorio si el esquema de partición para el servicio es Int64Range o Named. Los valores posibles son los siguientes.
- None (1): indica que no se especifica el parámetro PartitionKeyValue. Esto es válido para las particiones con el esquema de partición como Singleton. Este es el valor predeterminado. El valor es 1.
- Int64Range (2): indica que el parámetro PartitionKeyValue es una clave de partición int64. Esto es válido para las particiones con el esquema de partición como Int64Range. El valor es 2.
- Con nombre (3): indica que el parámetro PartitionKeyValue es un nombre de la partición. Esto es válido para las particiones con el esquema de partición como Named. El valor es 3.
PartitionKeyValue
Tipo: cadena
Obligatoria: no
Clave de partición. Es obligatorio si el esquema de partición para el servicio es Int64Range o Named.
Esto no es el identificador de partición, sino el valor de clave entero o el nombre del identificador de partición.
Por ejemplo, si el servicio usa particiones por rangos de 0 a 10, PartitionKeyValue sería un entero en ese rango. Consulte la descripción del servicio para ver el rango o el nombre.
PreviousRspVersion
Tipo: cadena
Obligatoria: no
El valor en el campo Versión de la respuesta que se recibió anteriormente. Es obligatorio si el usuario sabe que el resultado que se obtuvo anteriormente está obsoleto.
timeout
Tipo: entero (int64)
Obligatoria: no
Predeterminado:
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
Tiempo de espera del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar a que se complete la operación solicitada. El valor predeterminado para este parámetro es 60 segundos.
Respuestas
| Código de estado HTTP | Descripción | Esquema de respuesta |
|---|---|---|
| 200 (OK) | Una operación correcta devolverá el código de estado 200. |
ResolvedServicePartition |
| Todos los demás códigos de estado | Respuesta de error detallada. |
FabricError |