channel : annuler l’archivage

  • Article

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Restaurer un canal archivé. L’annulation de l’organisation permet aux utilisateurs d’envoyer des messages et de modifier le canal. Les canaux sont archivés via l’API d’archivage .

L’annulation de l’organisation est une opération asynchrone ; un canal est désarchivé lorsque l’opération asynchrone d’annulation d’archivage se termine correctement, ce qui peut se produire après la réponse de cette méthode.

Remarque : Un canal archivé qui appartient à une équipe archivée ne peut pas être désarchivé. Annuler l’archivage de l’équipe avant d’annuler l’archivage du canal ; sinon, une erreur se produit.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet
✅ ✅ ✅ ✅

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) ChannelSettings.ReadWrite.All Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application ChannelSettings.ReadWrite.All Non disponible.

Remarque: cet API prend en charge les autorisations d’administrateur. Les administrateurs généraux et administrateurs de services Microsoft Teams peuvent accéder à des équipes dont ils ne sont pas membres.

Requête HTTP

POST /teams/{team-id}/channels/{channel-id}/unarchive
POST /groups/{team-id}/team/channels/{channel-id}/unarchive

En-têtes de demande

En-tête Valeur
Autorisation Porteur {token}. Obligatoire.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si l’annulation de l’organisation a démarré avec succès, cette méthode retourne un 202 Accepted code de réponse. La réponse contient un Location en-tête, qui contient l’emplacement de teamsAsyncOperation qui a été créé pour gérer le désarchivage du canal de l’équipe. Vérifiez la status de l’opération de désarchiving en effectuant une requête GET à cet emplacement.

Exemple

Exemple 1 : Annuler l’archivage d’un canal

L’exemple suivant montre une demande d’annulation de l’archivage d’un canal.

Demande

POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/unarchive

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 202 Accepted
Location: /teams/{team-id}/operations/{operation-id}
Content-Type: text/plain
Content-Length: 0

Exemple 2 : Annuler l’archivage d’un canal lorsque l’équipe est archivée

L’exemple suivant montre une demande d’annulation de l’archivage d’un canal dans une équipe archivée.

Demande

POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/unarchive

Réponse

L’exemple suivant montre la 400 réponse d’erreur.

http/1.1 400 Bad Request
Content-Type: application/json
Content-Length: 193

{
    "error": {
        "code": "BadRequest",
        "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",
        "innerError": {
            "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",
            "code": "Unknown",
            "innerError": {},
            "date": "2023-12-11T04:26:35",
            "request-id": "8f897345980-f6f3-49dd-83a8-a3064eeecdf8",
            "client-request-id": "50a0er33-4567-3f6c-01bf-04d144fc8bbe"
        }
    }
}