Ciclo de vida da aplicação para o Armazenamento de Cópia de segurança do Microsoft 365

Integrar uma aplicação de armazenamento Cópia de segurança do Microsoft 365 de terceiros

Assim que a sua aplicação de Armazenamento Cópia de segurança do Microsoft 365 for dada autorização para ser executada no Inquilino a Consumir, para permitir que seja o Controlador de Armazenamento Cópia de segurança do Microsoft 365 num Inquilino Consumidor, tem de realizar as seguintes tarefas programáticas (através da sua aplicação):

1. Registe a sua aplicação como um Controlador de Armazenamento Cópia de segurança do Microsoft 365.

2. Verifique se o Serviço Cópia de segurança do Microsoft 365 está ativado no Inquilino de Consumo.

3. Ative a aplicação para ser o Controlador de Armazenamento Cópia de segurança do Microsoft 365.

   • Se existir um Controlador, aguarde pela conclusão do Período de Tolerância .

4. Ative a Política de Faturação no Inquilino de Consumo.

Depois de registar a aplicação, pode sempre verificar o estado da sua aplicação como Controlador de Armazenamento Cópia de segurança do Microsoft 365 ao executar a API Get serviceApp:

GET /solutions/backupRestore/serviceApps/{serviceAppId}

Passo 1: registar a aplicação como controlador de armazenamento do Cópia de segurança do Microsoft 365

Para registar a sua aplicação para ser um Controlador de Armazenamento Cópia de segurança do Microsoft 365, primeiro tem de registar a sua aplicação ao executar a API criar a Aplicação do serviço:

POST /solutions/backupRestore/serviceApps/

Se a aplicação tiver sido registada com êxito, esta tem um estado de inativo. O ID devolvido é o ID da Aplicação de Serviço da sua aplicação (que é o ID da Aplicação).

Passo 2: Verificar se o Serviço Cópia de segurança do Microsoft 365 está ativado no Inquilino que Está a Consumir

Para verificar se o Serviço Cópia de segurança do Microsoft 365 está ativado no Inquilino a Consumir, a aplicação tem de executar a API Get backupRestoreRoot:

GET /solutions/backupRestore/

Se o estado devolvido estiver ativado, este estado indica que existe um Controlador de Armazenamento Cópia de segurança do Microsoft 365 ativo e que a alteração do Controlador impõe um período de tolerância. Todos os outros estados indicam que não existe nenhum Controlador de Armazenamento Cópia de segurança do Microsoft 365 ativo e que uma aplicação pode tornar-se imediatamente o Controlador ao registar-se.

Passo 3: Ativar a aplicação para ser o Controlador de Armazenamento do Cópia de segurança do Microsoft 365

Para ativar a sua aplicação como o Controlador de Armazenamento Cópia de segurança do Microsoft 365 depende se já existe ou não um Controlador de Armazenamento de Cópia de segurança do Microsoft 365 existente (de terceiros ou de terceiros).

Nenhum Controlador de Armazenamento Cópia de segurança do Microsoft 365 existente

Se não existir nenhum Controlador de Armazenamento Cópia de segurança do Microsoft 365, pode ativar imediatamente a sua aplicação como Controlador. Para efetuar este passo, execute o serviceApp: ativar a API:

POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate

Se a aplicação tiver sido imediatamente ativada com êxito, esta tem um estado ativo.

Controlador de Armazenamento Cópia de segurança do Microsoft 365 Existente

Se existir um Controlador de Armazenamento Cópia de segurança do Microsoft 365 existente, quando ativar a aplicação como Controlador, tem de especificar uma data/hora sobre quando a alteração é efetiva. A data/hora tem de ser, pelo menos, 7 dias no futuro, mas não superior a 30 dias.

Para ativar a sua aplicação, tem de executar o serviceApp: ativar a API especificando a data/hora efetiva no corpo JSON do pedido:

POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate

Nota

Se já existir uma alteração pendente no Controlador de Armazenamento do Cópia de segurança do Microsoft 365 em curso, o pedido falhará com um código de erro HTTP 403. Não poderá ativar a sua aplicação até que a alteração pendente esteja concluída.

Se a aplicação tiver sido ativada com êxito para uma data/hora no futuro, esta tem um estado pendingActive.

Período de Tolerância do Controlador de Armazenamento Cópia de segurança do Microsoft 365 Existente

Se existir um Controlador de Armazenamento Cópia de segurança do Microsoft 365 quando ativou a aplicação, este passo impõe um Período de Tolerância entre 7 e 30 dias (conforme especificado quando ativou a aplicação).

Durante o Período de Tolerância:

• A sua aplicação tem o estado pendingActive.
• A sua aplicação tem acesso só de leitura a quaisquer Políticas de Proteção existentes. A sua aplicação não poderá alterar ou criar Políticas de Proteção nem efetuar quaisquer Restauros.
• O Administração de Cópia de Segurança de Inquilinos Consumidor pode cancelar a alteração pendente do Controlador de Armazenamento Cópia de segurança do Microsoft 365 e reverter para o estado original.
• A aplicação pode cancelar a alteração pendente do Controlador de Armazenamento do Cópia de segurança do Microsoft 365 e reverter para o estado original ao executar o serviceApp: desativar a API:

POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate

• A sua aplicação pode verificar o estado da sua aplicação como o Controlador de Armazenamento Cópia de segurança do Microsoft 365 ao executar a API Get serviceApp:

GET /solutions/backupRestore/serviceApps/{serviceAppId}

Após a conclusão do Período de Tolerância:

• A sua aplicação tem um estado ativo.

Passo 4: Ativar a Política de Faturação no Inquilino Que Está a Consumir

Assim que a aplicação tiver um estado ativo, tem de ativar a Política de Faturação no Inquilino que Está a Consumir. Este passo é executado ao executar a cópia de segurançaRestoreRoot: ativar a API:

POST /solutions/backupRestore/enable

Depois de ativar a Política de Faturação, a sua aplicação será o Controlador de Armazenamento Cópia de segurança do Microsoft 365 no Inquilino consumidor e agora poderá manter o Serviço de Cópia de segurança do Microsoft 365 (de acordo com os âmbitos de permissão oAuth da sua aplicação).

Nota

Pode executar esta API várias vezes na forma como é idempotente. Recomenda-se que ative a Política de Faturação no Inquilino que Está a Consumir se, por qualquer motivo, a Política de Faturação for alterada. Por exemplo, se quiser alterar o ID da Subscrição do Azure ou o Grupo de Recursos.

Exclusão de uma aplicação Cópia de segurança do Microsoft 365

Outra aplicação é Ativada como o Controlador de Armazenamento do Cópia de segurança do Microsoft 365

Se a sua aplicação for o Controlador de Armazenamento Cópia de segurança do Microsoft 365 ativo, é possível que outra aplicação (de terceiros ou de terceiros) também possa ser ativada de acordo com o processo de integração definido no Controlador de Armazenamento de Cópia de segurança do Microsoft 365 Existente e Existente Cópia de segurança do Microsoft 365 Período de Tolerância do Controlador de Armazenamento. Se este evento ocorrer, a sua aplicação não será explicitamente notificada. No entanto, o estado da sua aplicação fica pendenteInativo. T o obter o estado da sua aplicação sendo o Controlador de Armazenamento Cópia de segurança do Microsoft 365 a sua aplicação pode executar a API Get serviceApp:

GET /solutions/backupRestore/serviceApps/{serviceAppId}

Durante o Período de Tolerância:

• A sua aplicação tem o estado pendingInactive.
• A sua aplicação continua a ter acesso às Políticas de Proteção existentes e consegue alterar ou criar Políticas de Proteção ou efetuar quaisquer Restauros (de acordo com os âmbitos de permissão oAuth).
• A sua aplicação continua a ser responsável pela faturação Cópia de segurança do Microsoft 365 e, por conseguinte, pelo consumo no Inquilino de Consumo.
• O Administração de Cópia de Segurança do Inquilino consumidor pode cancelar a alteração pendente do Controlador de Armazenamento do Cópia de segurança do Microsoft 365 e reverter para o estado original, de modo a que a aplicação seja restaurada como o Controlador de Armazenamento Cópia de segurança do Microsoft 365 ativo.

Após a conclusão do Período de Tolerância:

• A sua aplicação tem um estado de inativo.
• A sua aplicação já não é responsável pela faturação Cópia de segurança do Microsoft 365 e, por conseguinte, pela faturação pay as you go no Inquilino de Consumo.

Desativar a aplicação como Controlador de Armazenamento do Cópia de segurança do Microsoft 365

Para desativar a aplicação de ser o Serviço Cópia de segurança do Microsoft 365 no Inquilino Que Está a Consumir, a sua aplicação tem de executar o serviceApp: desativar a API:

POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate

O resultado da desativação da aplicação depende do estado atual da sua aplicação.

Desativar com o estado atual de inativo

Desativar a aplicação que tem um estado de inativa não faz nada.

Desativar com o estado atual de pendingActive

Desativar a aplicação que tem um estado pendenteActive cancela a alteração pendente para se tornar o Controlador de Armazenamento Cópia de segurança do Microsoft 365. Depois de invocar com êxito a API:

• A sua aplicação tem um estado de inativo.
• A aplicação que é atualmente o Controlador de Armazenamento do Cópia de segurança do Microsoft 365 tem um estado ativo.

Desativar com o estado atual de pendingInactive

Desativar a aplicação que tem um estado de pendingInactive não fará nada com a alteração pendente do Controlador de Armazenamento Cópia de segurança do Microsoft 365. Ou seja, a alteração pendente continua até que o Período de Tolerância esteja concluído.

Desativar com o estado atual de ativo

Não é possível desativar a aplicação que tem um estado ativo e o pedido falha com um código HTTP de erro 403.

Para desativar a aplicação como Controlador de Armazenamento Cópia de segurança do Microsoft 365, outra aplicação tem de ser ativada ou pode anular o registo da aplicação para ser um Controlador de Armazenamento Cópia de segurança do Microsoft 365.

Anular o registo da aplicação como Controlador de Armazenamento do Cópia de segurança do Microsoft 365

Para anular o registo da aplicação de ser o Controlador de Armazenamento do Cópia de segurança do Microsoft 365 no Inquilino Que Está a Consumir, a aplicação tem de executar a API De aplicação eliminar serviço:

DELETE /solutions/backupRestore/serviceApps/{serviceAppId}

O resultado da anulação do registo da aplicação depende do estado atual da sua aplicação.

Anular o registo com o estado atual de inativo

Anular o registo da aplicação que tem um estado de inativo remove a sua aplicação como estando disponível para ser o Controlador de Armazenamento Cópia de segurança do Microsoft 365. Depois de invocar com êxito a API:

• A sua aplicação já não está disponível para se tornar o Controlador de Armazenamento do Cópia de segurança do Microsoft 365 (a menos que seja novamente registada).

Anular o registo com o estado atual de pendingActive

Anular o registo da aplicação com o estado pendingActive cancela a alteração pendente para se tornar o Controlador de Armazenamento Cópia de segurança do Microsoft 365. Depois de invocar com êxito a API:

• A sua aplicação já não está disponível para se tornar o Controlador de Armazenamento do Cópia de segurança do Microsoft 365 (a menos que seja novamente registada).
• A sua aplicação já não tem acesso só de leitura a quaisquer Políticas de Proteção existentes.
• A aplicação que é atualmente o Controlador de Armazenamento do Cópia de segurança do Microsoft 365 tem um estado ativo.

Anular o registo com o estado atual de pendingInactive

Não pode anular o registo da aplicação que tem o estado pendingInactive e o pedido falha com um código de erro HTTP 403.

Para anular o registo da aplicação como Controlador de Armazenamento do Cópia de segurança do Microsoft 365, tem de aguardar que o Período de Tolerância seja concluído (ou se a alteração pendente for cancelada e a aplicação for reposta como Controlador de Armazenamento Cópia de segurança do Microsoft 365).

Anular o registo com o estado atual de ativo

Anular o registo da aplicação com um estado ativo inicia automaticamente uma alteração pendente do Controlador de Armazenamento do Cópia de segurança do Microsoft 365 com um Período de Tolerância obrigatório de 7 dias.

Depois de invocar com êxito a API e durante o Período de Tolerância:

• A sua aplicação não poderá aceder, criar ou alterar políticas de proteção nem efetuar quaisquer Restauros.
• A sua aplicação já não está disponível para se tornar o Controlador de Armazenamento Cópia de segurança do Microsoft 365 (a menos que seja novamente registada).
• A sua aplicação continua a ser responsável pela faturação Cópia de segurança do Microsoft 365 e, por conseguinte, pelo consumo no Inquilino consumidor até que outra aplicação seja ativada para se tornar o Controlador de Armazenamento Cópia de segurança do Microsoft 365.

Após a conclusão do Período de Tolerância:

• A sua aplicação ainda não está disponível para se tornar o Controlador de Armazenamento do Cópia de segurança do Microsoft 365 (a menos que seja novamente registada).
• Se outra aplicação não estiver ativada para ser o Controlador de Armazenamento Cópia de segurança do Microsoft 365, é iniciada a exclusão do Serviço de Cópia de segurança do Microsoft 365 no Inquilino de Consumo.
• A aplicação continua a ser responsável pela faturação do Cópia de segurança do Microsoft 365 e, por conseguinte, pelo consumo no Inquilino consumidor até que outra aplicação seja ativada para ser o Controlador de Armazenamento Cópia de segurança do Microsoft 365 ou até que o período de faturação expire (30 dias) de acordo com a exclusão do Cópia de segurança do Microsoft 365 Serviço no Inquilino que Está a Consumir.

Aviso

Se a aplicação for o Controlador de Armazenamento Cópia de segurança do Microsoft 365 ativo ao anular o registo, é potencialmente responsável por mais 37 dias (7 dias mais 30 dias) para o Cópia de segurança do Microsoft 365 faturação pay as you go no Inquilino que Está a Consumir.

Estados do Ciclo de Vida da Aplicação

A inclusão e exclusão de uma aplicação Cópia de segurança do Microsoft 365 requer que a aplicação percorra vários estados diferentes. As alterações de estado são iniciadas por:

• Uma aplicação a invocar APIs específicas;
• A consequência de outra aplicação invocar APIs específicas; e/ou
• O sistema a aguardar um período de tempo.

O diagrama acima descreve os estados e os gestos que podem causar uma transição entre os mesmos:

1. Registar a aplicação como controlador de armazenamento do Cópia de segurança do Microsoft 365
2. Ativar a aplicação para ser o Controlador de Armazenamento Cópia de segurança do Microsoft 365 sem Controlador de Armazenamento Cópia de segurança do Microsoft 365 existente
3. Ative a aplicação para ser o Controlador de Armazenamento do Cópia de segurança do Microsoft 365 com um Controlador de Armazenamento Cópia de segurança do Microsoft 365 Existente e Outra aplicação é Ativada como a Cópia de segurança do Microsoft 365 Controlador de Armazenamento quando a aplicação é o Controlador de Armazenamento do Active Cópia de segurança do Microsoft 365
4. O Período de Tolerância do Controlador de Armazenamento Cópia de segurança do Microsoft 365 Existente é concluído
5. Desativar a aplicação para ser o Controlador de Armazenamento Cópia de segurança do Microsoft 365 com o estado atual de pendingActive
6. Anular o registo da aplicação para ser o Controlador de Armazenamento Cópia de segurança do Microsoft 365 com o estado atual de inativo
7. Anular o registo da aplicação para ser o Controlador de Armazenamento Cópia de segurança do Microsoft 365 com o estado atual de pendingActive
8. Anular o registo da aplicação para ser o Controlador de Armazenamento do Cópia de segurança do Microsoft 365 com o estado atual ativo