Compartir a través de

Partición de copia de seguridad

  • Artículo

Desencadena la copia de seguridad del estado de la partición.

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

Solicitud

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

Parámetros

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

partitionId

Tipo: cadena (uuid)
Obligatoria: sí

La identidad de la partición.

BackupTimeout

Tipo: entero
Obligatoria: no
Predeterminado:

Especifica la cantidad máxima de tiempo, en minutos, para esperar a que se complete la operación de copia de seguridad. Después, la operación se completa con el error de tiempo de espera. Sin embargo, en ciertos casos de esquina podría ser que, aunque la operación devuelva el tiempo de espera, la copia de seguridad realmente pasa por. 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.

BackupPartitionDescription

Tipo: BackupPartitionDescription
Obligatoria: no

Describe los parámetros para realizar una copia de seguridad de la partición ahora. Si no está presente, la operación de copia de seguridad usa parámetros predeterminados de la directiva de copia de seguridad actual asociada a esta 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 copia de seguridad. Use la operación GetPartitionBackupProgress para obtener el estado de la operación de copia de seguridad.
Todos los demás códigos de estado Respuesta de error detallada.
 FabricError

Ejemplos

Partición de copia de seguridad

En este ejemplo se muestra cómo desencadenar la copia de seguridad de una partición ahora, que ya está configurada para copias de seguridad periódicas. La copia de seguridad recién creada se guardará en la misma ubicación donde se guardan las copias de seguridad periódicas.

Request

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Cuerpo
{}

Respuesta 202

Cuerpo

El cuerpo de la respuesta está vacío.

Copia de seguridad de la partición en una cuenta de Almacenamiento de Azure específica

En este ejemplo se muestra cómo desencadenar la copia de seguridad de una partición ahora y guardar la copia de seguridad en una cuenta específica de Azure Blob Storage.

Request

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Cuerpo
{
  "BackupStorage": {
    "StorageKind": "AzureBlobStore",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  }
}

Respuesta 202

Cuerpo

El cuerpo de la respuesta está vacío.

Copia de seguridad de la partición en una ubicación de almacenamiento de Azure específica a la que se accede mediante la identidad administrada

En este ejemplo se muestra cómo desencadenar la copia de seguridad de una partición ahora y guardar la copia de seguridad en una cuenta específica de Azure Blob Storage mediante la identidad administrada.

Request

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Cuerpo
{
  "BackupStorage": {
    "StorageKind": "ManagedIdentityAzureBlobStore",
    "BlobServiceUri": "https://managedidentitytest.blob.core.windows.net/",
    "ContainerName": "BackupContainer",
    "ManagedIdentityType": "Cluster"
  }
}

Respuesta 202

Cuerpo

El cuerpo de la respuesta está vacío.

Copia de seguridad de la partición en un recurso compartido de archivos local específico

En este ejemplo se muestra cómo desencadenar la copia de seguridad de una partición ahora y guardar la copia de seguridad en un recurso compartido de archivos específico accesible desde todos los nodos del clúster.

Request

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Cuerpo
{
  "BackupStorage": {
    "StorageKind": "FileShare",
    "Path": "\\\\myshare\\backupshare",
    "PrimaryUserName": "mydomain\\backupaccount",
    "PrimaryPassword": "abcd1234"
  }
}

Respuesta de 202

Cuerpo

El cuerpo de la respuesta está vacío.

Copia de seguridad de la partición en una ubicación específica de Azure Storage de Dsms

En este ejemplo se muestra cómo desencadenar la copia de seguridad de una partición ahora y guardar la copia de seguridad en una ubicación específica de Azure Blob Storage de Dsms.

Request

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Cuerpo
{
  "BackupStorage": {
    "StorageKind": "DsmsAzureBlobStore",
    "StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
    "ContainerName": "BackupContainer"
  }
}

Respuesta de 202

Cuerpo

El cuerpo de la respuesta está vacío.