Compartir a través de

Restaurar partición

  • Artículo

Desencadena la restauración del estado de la partición mediante la descripción de partición de restauración especificada.

Restaura el estado de una de la partición persistente con estado mediante el punto de copia de seguridad especificado. En caso de que ya se realice una copia de seguridad periódica de la partición, el punto de copia de seguridad se busca de forma predeterminada en el almacenamiento especificado en la directiva de copia de seguridad. También puede invalidar lo mismo especificando los detalles del almacenamiento de copia de seguridad como parte de la descripción de la partición de restauración en el cuerpo. Una vez iniciada la restauración, se puede realizar un seguimiento de su progreso mediante la operación GetRestoreProgress. En caso de que la operación agote el tiempo de espera, especifique un valor de tiempo de espera de restauración mayor en el parámetro de consulta.

Solicitud

Método URI de solicitud
POST /Partitions/{partitionId}/$/Restore?RestoreTimeout={RestoreTimeout}&api-version=6.4&timeout={timeout}

Parámetros

Nombre Tipo Requerido Ubicación
partitionId string (uuid) Sí Ruta de acceso
RestoreTimeout integer No Consultar
api-version string Sí Consultar
timeout entero (int64) No Consultar
RestorePartitionDescription RestorePartitionDescription Sí Body

partitionId

Tipo: cadena (uuid)
Obligatoria: sí

La identidad de la partición.

RestoreTimeout

Tipo: entero
Obligatoria: no
Predeterminado:

Especifica la cantidad máxima de tiempo que se va a esperar, en minutos, para que se complete la operación de restauración. Post that, the operation returns back with timeout error. Sin embargo, en ciertos casos de esquinas, podría ser que la operación de restauración pase a través aunque se complete con el tiempo de espera. En caso de error de tiempo de espera, se recomienda invocar esta operación de nuevo con un valor de tiempo de espera mayor. el valor predeterminado para el mismo es de 10 minutos.

api-version

Tipo: cadena
Obligatoria: sí
Predeterminado:

La versión de la API. Este parámetro es necesario y su valor debe ser "6.4".

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 versión es la versión compatible más reciente de la API. Si se pasa una versión de API anterior, 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 compatible 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 la 6.0 y el entorno de ejecución es 6.1, 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 documentada 6.0.

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.

RestorePartitionDescription

Tipo: RestorePartitionDescription
Obligatoria: sí

Describe los parámetros para restaurar la partición.

Respuestas

Código de estado HTTP Descripción Esquema de respuesta
202 (Accepted) Un código de estado 202 indica que se aceptó la solicitud de operación y se iniciará la restauración. Use la operación GetPartitionRestoreProgress para obtener el estado de la operación de restauración.
Todos los demás códigos de estado Respuesta de error detallada.
 FabricError

Ejemplos

Desencadenar la restauración de particiones

En este ejemplo se muestra cómo desencadenar la restauración de una partición especificando la copia de seguridad que se va a usar para restaurar.

Request

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Restore?api-version=6.4
Cuerpo
{
  "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
  "BackupStorage": {
    "StorageKind": "AzureBlobStore",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  },
  "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip"
}

Respuesta 202

Cuerpo

El cuerpo de la respuesta está vacío.