名前空間: microsoft.graph.teamsAdministration
このメソッドは、省略可能な属性を使用して既存の数値を更新するために使用されます。 現在サポートされている属性は、 locationId、 networkSiteId、および reverseNumberLookupOptionsです。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | TeamsTelephoneNumber.ReadWrite.All | 注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | TeamsTelephoneNumber.ReadWrite.All | 注意事項なし。 |
HTTP 要求
POST /admin/teams/telephoneNumberManagement/numberAssignments/updateNumber
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
| Content-Type | application/json. 必須です。 |
要求本文
要求本文で、パラメーターの JSON 表現を指定します。
次の表に、このアクションを呼び出すときに必要なパラメーターを示します。
| パラメーター | 型 | 説明 |
|---|---|---|
| telephoneNumber | 文字列 | 必須。 割り当てられる電話番号。 |
| locationId | 文字列 | 電話番号に設定されている緊急住所識別子を示します。 空の文字列を渡すと locationId がクリアされますが、 null を渡すか、フィールドを含めずに渡すと、既存の値が保持されます。 |
| networkSiteId | 文字列 | 更新された networkSiteId を示します。 空の文字列を使用して既存の networkSiteId をクリアするか、フィールドを null/省略して既存の値を保持します。 |
| reverseNumberLookupOptions | String collection | このパラメーターは、電話番号の逆引き番号参照 (RNL) の動作を制御するために使用されます。 RNL に skipInternalVoipが含まれている場合、この電話番号への内部呼び出しでは、Microsoft Teamsの逆引き番号参照を介して内部 VoIP を通過しようとしません。 代わりに、通話は外部の公衆交換電話網 (PSTN) 接続を介して直接確立されます。 |
応答
成功した場合、このメソッドは 200 OK 応答コードを返します。
例
例 1: 場所 ID を更新する
要求
次の例は、電話番号の locationId を更新する要求を示しています。
POST https://graph.microsoft.com/v1.0/admin/teams/telephoneNumberManagement/numberAssignments/updateNumber
Content-Type: application/json
{
"telephoneNumber": "+12061234567",
"locationId": "93cb8a70-b4af-41df-9928-d07607e21776",
}
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
例 2: ネットワーク サイト ID を更新する
要求
次の例は、電話番号の networkSiteId を更新する要求を示しています。
POST https://graph.microsoft.com/v1.0/admin/teams/telephoneNumberManagement/numberAssignments/updateNumber
Content-Type: application/json
{
"telephoneNumber": "+12061234567",
"networkSiteId": "fff21455-0f84-4a6b-babd-0a9b46971a62",
}
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
例 3: 逆引き番号参照オプションを更新する
要求
次の例は、リソース アカウントに関連付けられている電話番号の reverseNumberLookupOptions を更新する要求を示しています。
POST https://graph.microsoft.com/v1.0/admin/teams/telephoneNumberManagement/numberAssignments/updateNumber
Content-Type: application/json
{
"telephoneNumber": "+12061234567",
"reverseNumberLookupOptions": ["skipInternalVoip"],
}
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
例 4: 場所 ID をクリアする
要求
次の例は、電話番号の locationId を更新する要求を示しています。
POST https://graph.microsoft.com/v1.0/admin/teams/telephoneNumberManagement/numberAssignments/updateNumber
Content-Type: application/json
{
"telephoneNumber": "+12061234567",
"locationId": "",
}
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK