del método Site.CreateMigrationJob
Este método crea una nueva tarea de importación de migración y colas para su posterior procesamiento por un trabajo del temporizador independiente. El trabajo consume un paquete de importación correcto (formato predefinidos) que se encuentra en los contenedores de almacenamiento de blobs de Windows Azure especificado en este método. El contrato de nivel de servicio (SLA) para el procesamiento de trabajos de migración se controla mediante cola preconfigurada y configuración de la limitación de carga de trabajo y hay ninguna garantía SLA o el tiempo de retorno para un trabajo enviado.
Espacio de nombres: Microsoft.SharePoint.Client
Ensamblados: Microsoft.SharePoint.Client.Silverlight (en Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (en Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (en Microsoft.SharePoint.Client.dll)
Sintaxis
'Declaración
Public Function CreateMigrationJob ( _
gWebId As Guid, _
azureContainerSourceUri As String, _
azureContainerManifestUri As String, _
azureQueueReportUri As String _
) As ClientResult(Of Guid)
'Uso
Dim instance As Site
Dim gWebId As Guid
Dim azureContainerSourceUri As String
Dim azureContainerManifestUri As String
Dim azureQueueReportUri As String
Dim returnValue As ClientResult(Of Guid)
returnValue = instance.CreateMigrationJob(gWebId, _
azureContainerSourceUri, azureContainerManifestUri, _
azureQueueReportUri)
public ClientResult<Guid> CreateMigrationJob(
Guid gWebId,
string azureContainerSourceUri,
string azureContainerManifestUri,
string azureQueueReportUri
)
Parámetros
gWebId
Tipo: System.GuidIdentificador único de la web de destino para la importación de paquete. Información adicional y los identificadores para la importación se especifican en el mismo paquete de importación. Este identificador puede encontrarse mediante programación consultando la web de destino con la API de cliente de SharePoint.
azureContainerSourceUri
Tipo: System.StringUna URL válida, incluido el token de SA para tener acceso al contenedor de almacenamiento de blobs de Windows Azure que contiene los archivos binarios del bloque de tipo. Se debe crear el token de SA con solo lectura y permisos de lista o el trabajo de migración se producirá un error. El token de sa debe tener una duración que comienza después que cuando se envió el trabajo, hasta que haya pasado un tiempo razonable de importación correcta para finalizadas (mínimo).
azureContainerManifestUri
Tipo: System.StringLa dirección URL válida incluidos token SA para tener acceso al contenedor de almacenamiento de blobs de Windows Azure que contiene el BLOB bloque para el manifiesto y otros archivos XML que describen el paquete. Esta ubicación también se utilizará para el resultado del registro. Este contenedor no puede ser el mismo que el utilizado para el azureContainerSourceUri. Debe haber creado el token de SA con solo lectura, lista y permisos de escritura o el trabajo de migración se producirá un error. El token de sa debe tener al menos una duración que comienza después que cuando se envió el trabajo, hasta que haya pasado un tiempo razonable de importación correcta para finalizadas.
azureQueueReportUri
Tipo: System.StringLa dirección URL válida incluidos token SA para obtener acceso al usuario proporcionado cola de Azure que se utiliza para las notificaciones de progreso de tarea de migración. Este valor puede ser null si no hay cola de notificación se utilizará durante la importación. Si este valor no es nulo y se concede acceso adecuado en el token de SA en este URI, se usará para la actualización de estado en tiempo real.
Valor devuelto
Tipo: Microsoft.SharePoint.Client.ClientResult<Guid>
Si el trabajo correctamente en cola o si no funciona, se devolverá un valor nulo, se devuelve el identificador único para el trabajo de migración. Puede obtener el estado del trabajo con el identificador único y el método GetMigrationJobStatus . Puede eliminar el trabajo de migración con el identificador y el método DeleteMigrationJob .
Comentarios
El contenedor especificado en azureContainerSourceUri debe tener los permisos siguientes: (SharedAccessBlobPermissions.Read | SharedAccessBlobPermissions.List).
Todos los archivos en el contenedor deben tener al menos una sola instantánea aplicada para asegurarse de que no puede producirse modificar el archivo desde el cliente durante la importación. Se omitirá cualquier archivo que no tenga una instantánea durante la importación y se producirá un error, aunque el trabajo intentará continuar importar. La canalización de importación utilizará la instantánea más reciente del archivo disponible en el momento de la importación. El siguiente es un ejemplo de código que puede utilizar para crear una instantánea en un archivo después de que se carga en el almacenamiento de blobs de Windows Azure:
CloudBlockBlob blob = blobContainerObj.GetBlockBlobReference(file);
blob.UploadFromStream(stm);
blob.CreateSnapshot()
Todos los archivos en el contenedor especificado por azureContainerManifestUri deben tener al menos una sola instantánea aplicada para asegurarse de que no puede producirse modificar el archivo desde el cliente durante la importación. Cualquier archivo que no tenga una instantánea provocará errores durante la importación y producirá un error, posiblemente causando el trabajo de migración completo no se realice correctamente.
La cola especificada en azureQueueReportUri debe tener los permisos siguientes: (SharedAccessQueuePermissions.Add | SharedAccessQueuePermissions.Read | SharedAccessQueuePermissions.Update) Una vez aceptada, el identificador de trabajo se escribirá en la cola de notificación si se proporcionó y acceso es válido. La cola de notificación de puede usarse para varias tareas de migración al mismo tiempo, como cada trabajo se identificarse en los valores que se envían a la cola de notificación.
Ejemplos
Guid MigrationJobId = TargetSite.CreateMigrationJob(
TargetWebId,
azureContainerSourceUri,
azureContainerManifestUri,
azureQueueReportUri);