次の方法で共有


plannerPlan: アーカイブ

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

plannerPlan オブジェクトをアーカイブします。 プランをアーカイブし、 計画の plannerTasksplannerBuckets もアーカイブします。

アーカイブされたエンティティは読み取り専用です。 アーカイブされたエンティティは更新できません。

アーカイブされたプランは 、アーカイブ解除できます。

アーカイブされたすべてのエンティティを削除できます。

アーカイブされたタスクは、 ユーザーに割り当てられたタスクの一覧の応答には含まれません。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) Tasks.ReadWrite 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Tasks.ReadWrite.All 注意事項なし。

HTTP 要求

POST /planner/plans/{planId}/archive

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。
Content-Type application/json. Required.
If-Match plannerPlan がアーカイブされる最後の既知の ETag 値。 必須です。

要求本文

要求本文で、パラメーターの JSON 表現を指定します。

次の表に、このアクションを呼び出すときに必要なパラメーターを示します。

パラメーター 説明
ジャスティフィケーション String プランがアーカイブされている理由。

応答

成功した場合、このアクションは 204 No Content 応答コードを返します。

このメソッドは、 任意の HTTP 状態コードを返すことができます。 この方法でアプリで処理する必要がある最も一般的なエラーは、400 応答と 403 応答です。 これらのエラーの詳細については、「 Common Planner のエラー条件」を参照してください。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/beta/planner/plans/{planId}/archive
Content-Type: application/json

{
  "justification": "String"
}

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 204 No Content