Excluir teamsApp

Namespace: microsoft.graph

Excluir um aplicativo do catálogo de aplicativos de uma organização (o catálogo de aplicativos do locatário). Para excluir um aplicativo, a propriedade distributionMethod do aplicativo deve ser definida como organization.

Você também pode usar essa API para remover um aplicativo enviado do processo de revisão.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

O- Somente administradores de serviços do Teams ou uma função privilegiada superior podem chamar essa API.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
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 tem suporte apenas para compatibilidade com versões anteriores. 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.
  • Você só pode usar a permissão AppCatalog.Submit para excluir definições de aplicativo na revisão.

Solicitação HTTP

Para excluir um aplicativo do catálogo de aplicativos:

DELETE /appCatalogs/teamsApps/{id}

Para excluir um aplicativo enviado, mas que ainda não foi aprovado:

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.

Observação: Use a ID retornada da chamada List published apps para fazer referência ao aplicativo que você deseja excluir. Não use a ID do manifesto do pacote do aplicativo zip.

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content. Ele não retorna 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

Limites de limitação específicos do serviço do Microsoft Graph