Create vppToken
名前空間: microsoft.graph
大事な: /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
新規にvppTokenオブジェクトを作成します。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
---|---|
委任 (職場または学校のアカウント) | DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementConfiguration.ReadWrite.All |
委任 (個人用 Microsoft アカウント) | サポートされていません。 |
アプリケーション | DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementConfiguration.ReadWrite.All |
HTTP 要求
POST /deviceAppManagement/vppTokens
要求ヘッダー
ヘッダー | 値 |
---|---|
Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
承諾 | application/json |
要求本文
要求本文で、vppToken オブジェクトの JSON 表記を指定します。
次の表に、vppToken 作成時に必要なプロパティを示します。
プロパティ | 型 | 説明 |
---|---|---|
id | String | appleVolumePurchaseProgramToken 作成時に自動的に生成されます。 エンティティのキーになります。 |
organizationName | String | Apple ボリューム購入プログラムのトークンに関連付けられている組織 |
vppTokenAccountType | vppTokenAccountType | 特定の Apple ボリューム購入プログラムのトークンが関連付けられている、ボリューム購入プログラムの種類。 可能な値は、business 、education です。 可能な値は、business 、education です。 |
appleId | String | 特定の Apple ボリューム購入プログラムのトークンに関連付けられている Apple ID。 |
expirationDateTime | DateTimeOffset | Apple ボリューム購入プログラムのトークンの有効期限。 |
lastSyncDateTime | DateTimeOffset | Apple ボリューム購入プログラムのトークンを使用して、Apple ボリューム購入プログラム サービスと最後にアプリケーションの同期を行った日時。 |
token | String | Apple ボリューム購入プログラムからダウンロードした Apple ボリューム購入プログラムのトークン文字列。 |
lastModifiedDateTime | DateTimeOffset | Apple ボリューム購入プログラムのトークンに関連付けられている最終変更日時。 |
state | vppTokenState | Apple ボリューム購入プログラムのトークンの現在の状態。 可能な値は、unknown 、valid 、expired 、invalid 、assignedToExternalMDM です。 使用可能な値: unknown 、valid 、expired 、invalid 、assignedToExternalMDM 、duplicateLocationId 。 |
tokenActionResults | vppTokenActionResult コレクション | Apple ボリューム購入プログラム トークンに対して実行されたアクションの状態のコレクション。 |
lastSyncStatus | vppTokenSyncStatus | Apple ボリューム購入プログラム トークンを使用して行われた最後のアプリケーションの同期の現在の同期状態。 可能な値は、none 、inProgress 、completed 、failed です。 可能な値は、none 、inProgress 、completed 、failed です。 |
automaticallyUpdateApps | Boolean | VPP トークンのアプリを自動で更新するかどうか。 |
countryOrRegion | String | VPP トークンのアプリを自動で更新するかどうか。 |
dataSharingConsentGranted | ブール型 | Apple ボリューム購入プログラムとのデータ共有に対する同意。 |
displayName | String | 管理者がトークンフレンドリ名を指定しました。 |
locationName | String | Apple VPP から返されるトークンの場所。 |
claimTokenManagementFromExternalMdm | ブール型 | 管理外部 MDM からのトークン管理の要求を許可することに同意します。 |
roleScopeTagIds | String collection | このエンティティに割り当てられたロール スコープ タグ ID。 |
応答
成功した場合、このメソッドは 201 Created
応答コードと、応答本文で vppToken オブジェクトを返します。
例
要求
以下は、要求の例です。
POST https://graph.microsoft.com/beta/deviceAppManagement/vppTokens
Content-type: application/json
Content-length: 1002
{
"@odata.type": "#microsoft.graph.vppToken",
"organizationName": "Organization Name value",
"vppTokenAccountType": "education",
"appleId": "Apple Id value",
"expirationDateTime": "2016-12-31T23:57:57.2481234-08:00",
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
"token": "Token value",
"state": "valid",
"tokenActionResults": [
{
"@odata.type": "microsoft.graph.vppTokenActionResult",
"actionName": "Action Name value",
"actionState": "pending",
"startDateTime": "2016-12-31T23:58:46.7156189-08:00",
"lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
}
],
"lastSyncStatus": "inProgress",
"automaticallyUpdateApps": true,
"countryOrRegion": "Country Or Region value",
"dataSharingConsentGranted": true,
"displayName": "Display Name value",
"locationName": "Location Name value",
"claimTokenManagementFromExternalMdm": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
]
}
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1115
{
"@odata.type": "#microsoft.graph.vppToken",
"id": "9ceb2f92-2f92-9ceb-922f-eb9c922feb9c",
"organizationName": "Organization Name value",
"vppTokenAccountType": "education",
"appleId": "Apple Id value",
"expirationDateTime": "2016-12-31T23:57:57.2481234-08:00",
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
"token": "Token value",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"state": "valid",
"tokenActionResults": [
{
"@odata.type": "microsoft.graph.vppTokenActionResult",
"actionName": "Action Name value",
"actionState": "pending",
"startDateTime": "2016-12-31T23:58:46.7156189-08:00",
"lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
}
],
"lastSyncStatus": "inProgress",
"automaticallyUpdateApps": true,
"countryOrRegion": "Country Or Region value",
"dataSharingConsentGranted": true,
"displayName": "Display Name value",
"locationName": "Location Name value",
"claimTokenManagementFromExternalMdm": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
]
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示