channel : annuler l’archivage
Espace de noms: microsoft.graph
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 la méthode channel : archive .
L’annulation de l’organisation est une opération asynchrone ; un canal est désarchivé lorsque l’opération d’annulation asynchrone 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, la requête échoue.
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 utilisateurs disposant du rôle Administrateur général ou Administrateur de service Microsoft Teams peuvent accéder aux é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
| Nom | Description |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
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 spécifie l’emplacement de teamsAsyncOperation qui a été créé pour gérer le désarchiving du canal dans une équipe. Vérifiez l’état de l’opération de désarchiving en effectuant une requête GET à cet emplacement.
Exemples
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/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/unarchive
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 202 Accepted
Location: /teams/16dc05c0-2259-4540-a970-3580ff459721/operations/b7ee702a-d87f-4cc6-82b9-e731c16d3aba
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 qui échoue parce que l’équipe est archivée ; l’équipe doit être active pour archiver ou annuler l’archivage d’un canal.
Demande
POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/unarchive
Réponse
L’exemple suivant montre le code de 400 Bad Request réponse avec un message d’erreur correspondant.
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"
}
}
}