Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Eliminar uma aplicação do catálogo de aplicações de uma organização (o catálogo de aplicações do inquilino). Para eliminar uma aplicação, a propriedade distributionMethod da aplicação tem de ser definida como organization.
Também pode utilizar esta API para remover uma aplicação submetida do processo de revisão.
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
O- Apenas os administradores do Serviço Teams ou uma função com privilégios superiores podem chamar esta API.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | AppCatalog.Submit | AppCatalog.ReadWrite.All, Directory.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Aplicativo | Sem suporte. | Sem suporte. |
Observação
- A permissão Directory.ReadWrite.All é suportada apenas para retrocompatibilidade. Recomendamos que você atualize suas soluções para usar uma permissão alternativa listada na tabela anterior e evite usar essas permissões daqui para frente.
- Só pode utilizar a permissão AppCatalog.Submit para eliminar definições de aplicações em revisão.
Solicitação HTTP
Para eliminar uma aplicação do catálogo de aplicações:
DELETE /appCatalogs/teamsApps/{id}
Para eliminar uma aplicação submetida, mas que ainda não foi aprovada:
DELETE appCatalogs/teamsApps/{appId}/appDefinitions/{appDefinitionId}
Cabeçalhos de solicitação
| Cabeçalho | Valor |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Nota: Utilize o ID devolvido da chamada Lista de aplicações publicadas para referenciar a aplicação que pretende eliminar. Não utilize o ID do manifesto do pacote da aplicação zip.
Resposta
Se tiver êxito, este método retornará um código de resposta 204 No Content. Não devolve nada no corpo da resposta.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
DELETE https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content
Conteúdo relacionado
Limites de limitação específicos do serviço do Microsoft Graph