Site.CreateMigrationJob método

Este método cria uma nova tarefa de importação de migração e filas-lo para processamento posterior por um trabalho de timer separado. O trabalho será consumir um pacote de importação de bem formados (formato predefinidos) que está localizado no Azure Blob Storage contêiner (s) especificada neste método. O contrato de nível de serviço (SLA) para processamento de trabalho de migração será controlado pelo fila pré-configurado e configurações de otimização de carga de trabalho e há nenhuma garantia SLA ou a hora de retorno para um trabalho enviado.

Namespace:  Microsoft.SharePoint.Client
Assemblies:   Microsoft.SharePoint.Client.Silverlight (em Microsoft.SharePoint.Client.Silverlight.dll);  Microsoft.SharePoint.Client.Phone (em Microsoft.SharePoint.Client.Phone.dll)  Microsoft.SharePoint.Client (em Microsoft.SharePoint.Client.dll)

Sintaxe

'Declaração
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.Guid

  O identificador exclusivo da web de destino para a importação de pacote. Informações adicionais e identificadores para a importação são especificados dentro do pacote de importação em si. Esse identificador pode ser encontrado programaticamente consultando na web de destino usando a API do cliente do SharePoint.

• azureContainerSourceUri
  Tipo: System.String

  Uma URL válida, incluindo o token SAS para acessar o contêiner de armazenamento de Blob do Azure que contém os arquivos binários do bloco de tipo. O token SAS deve ser criado com somente leitura e permissões de lista ou o trabalho de migração falhará. O token SAS deve ter (pelo menos) uma vida útil que começa não posteriores ao quando o trabalho foi enviado, até que um tempo razoável passou para importação bem-sucedida concluíram.

• azureContainerManifestUri
  Tipo: System.String

  A URL válida incluindo token SAS para acessar o contêiner de armazenamento de Blob do Azure que contém os blobs de bloco para o manifesto e outros arquivos XML que descrevem o pacote. Deste local também será usado para o log de saída. Este contêiner não pode ser o mesmo usado para a azureContainerSourceUri. O token SAS deve ter sido criado com somente leitura, lista e permissões de gravação ou o trabalho de migração falhará. O token SAS deve ter pelo menos uma vida útil que começa não posteriores ao quando o trabalho foi enviado, até que um tempo razoável passou para importação bem-sucedida concluíram.

• azureQueueReportUri
  Tipo: System.String

  A URL válida, incluindo token SAS para acessar o usuário fornecido fila Azure usado para notificações de progresso do trabalho de migração. Este valor pode ser null se nenhuma fila de notificação será usada durante a importação. Se esse valor não é nulo e acesso apropriado é concedido no token SAS nesse URI, ele será usado para atualização de status de tempo real.

Valor retornado

Tipo: Microsoft.SharePoint.Client.ClientResult<Guid>
O identificador exclusivo para o trabalho de migração será retornado se o trabalho está na fila com êxito, ou se for bem-sucedida, será retornado um valor nulo. Você pode obter o status do trabalho usando este identificador exclusivo e o método de GetMigrationJobStatus . Você pode excluir o trabalho de migração usando esse identificador e o método de DeleteMigrationJob .

Comentários

O contêiner especificado na azureContainerSourceUri deve ter as seguintes permissões: (SharedAccessBlobPermissions.Read | SharedAccessBlobPermissions.List).

Todos os arquivos no contêiner devem ter pelo menos um instantâneo único aplicado a eles para garantir que nenhuma modificação de arquivo pode ocorrer do cliente durante a importação. Qualquer arquivo que não tem um instantâneo será ignorado durante a importação e um erro será lançado, embora o trabalho tentará continuar a importar. O pipeline de importação usará o instantâneo mais recente do arquivo disponível no momento da importação. Este é um exemplo de código que você pode usar para criar um instantâneo em um arquivo depois de ser carregada para o armazenamento de Blob do Azure:

CloudBlockBlob blob = blobContainerObj.GetBlockBlobReference(file);
blob.UploadFromStream(stm);
blob.CreateSnapshot()

Todos os arquivos no contêiner especificado pelo azureContainerManifestUri devem ter pelo menos um instantâneo único aplicado a eles para garantir que nenhuma modificação de arquivo pode ocorrer do cliente durante a importação. Qualquer arquivo que não tem um instantâneo causará falhas durante a importação e irá acionar um erro, possivelmente causando o trabalho de migração inteira falha.

A fila especificada na azureQueueReportUri deve ter as seguintes permissões: (SharedAccessQueuePermissions.Add | SharedAccessQueuePermissions.Read | SharedAccessQueuePermissions.Update) Depois de aceita, a ID de trabalho será gravada na fila de notificação se ele foi fornecido e acesso é válido. Fila de notificação pode ser usada para vários trabalhos de migração, ao mesmo tempo, como cada trabalho identificar-se nos valores enviadas de volta para a fila de notificação.

Exemplos

Guid MigrationJobId = TargetSite.CreateMigrationJob(
    TargetWebId,
    azureContainerSourceUri,
    azureContainerManifestUri,
    azureQueueReportUri);

Ver também

Referência

Site classe

Site membros

Microsoft.SharePoint.Client namespace