Global Admin Console にログインします。「組織」タブで、組織ピッカーを使用して、書き出しを実行する組織階層を選択します。階層内のすべての組織のデータが書き出されます。
- アドビエンタープライズ版とグループ版:管理ガイド
- デプロイメントの計画
- 基本概念
- デプロイメントガイド
- Creative Cloud 教育機関向けのデプロイ
- 組織の設定
- ID タイプ | 概要
- ID の設定 | 概要
- Enterprise ID を使用した組織の設定
- Azure AD フェデレーションと同期の設定
- Google Federation と Google Sync の設定
- Microsoft ADFS を使用した組織の設定
- 組織の教育委員会ポータルと LMS の設定
- 他の ID プロバイダーを使用した組織の設定
- SSO に関するよくある質問とトラブルシューティング
- 組織の設定の管理
- ユーザーの管理
- 製品および使用権限の管理
- 製品および製品プロファイルの管理
- 共有デバイスライセンスの管理
- 製品および製品プロファイルの管理
- Global Admin Console の使用を開始
- ストレージとアセットの管理
- ストレージ
- アセットの移行
- ユーザーのアセットの再利用
- 学生アセットの移行 | 教育機関のみ
- Managed Services
- Adobe Stock
- カスタムフォント
- Adobe Asset Link
- Adobe Acrobat Sign
- Creative Cloud エンタープライズ版 – 無料メンバーシップ
- アプリおよびアップデートのデプロイ
- 概要
- パッケージの作成
- パッケージのカスタマイズ
- パッケージのデプロイ
- アップデートの管理
- Adobe Update Server Setup Tool(AUSST)
- Adobe Remote Update Manager(RUM)
- トラブルシューティング
- グループ版アカウントの管理
- 更新
- 契約の管理
- レポートとログ
- ヘルプを表示
グローバル管理者が Global Admin Console の書き出し機能と読み込み機能を使用して組織と製品の管理を効率化する方法について説明します。
Global Admin Console の「組織」タブにアクセスして組織構造を書き出しまたは読み込み、割り当てデータの「製品の割り当て」タブに移動します。詳細オプション アイコンを使用して、書き出しまたは読み込みを選択します。
組織構造の書き出し
グローバル管理者は、組織階層を書き出すことができます。組織階層全体、またはサブセットを JSON、CSV、または XLSX 表現でダウンロードできます。このデータは、分析や修正に使用できます。
選択した書き出し形式によって、書き出されるデータの構造が異なります。
- CSV 形式:一度に 1 種類のデータのみを書き出すことができます。製品プロファイルを CSV 形式でエクスポートすると、プロファイルとリソースが 1 つのテーブルにまとめられます。製品プロファイルには、リソースごとに 1 つずつ、複数のエントリがあります。
- XLSX 形式:各組織の詳細が別のシートに表示されます。
レコードは、参照 ID によって異なるオブジェクトタイプ間で接続されます。リソースオブジェクトのように、特定のリソースに一連の値が関連付けられている場合、特定のオブジェクトに対して複数の行が存在することがあります。
- JSON 形式:最も柔軟な形式です。書き出されたオブジェクト間の構造的関係を利用できます。例えば、組織内の製品は、組織要素に直接表示されます。同じフィールドが 3 つのすべての形式で書き出されますが、JSON 形式では一部の値が重複します。
-
-
詳細オプション
アイコンを選択し、「書き出し」を選択します。 -
書き出しダイアログで、書き出すデータとデータを書き出す形式を選択します。
-
「書き出し」を選択します。 書き出しファイルの生成には数分かかる場合があります。完了後にレポートをダウンロードするには、Global Admin Console/Insights/レポートの書き出しに移動します。書き出しレポートについて詳しくはこちらを参照してください。
注意:JSON ファイルは zip 形式で書き出されます。zip ユーティリティまたはオペレーティングシステムの zip 機能を使用して開くことができます。
ファイルをダウンロードしたら、データを操作して再び読み込むことができます。更新したデータを読み込むと、データを手動で編集した場合と同じ方法で、Global Admin Console に表示されます。
組織構造の読み込み
グローバル管理者は、変更された可能性のあるデータを読み込むことができます。アップロードされると、新しいデータが現在のデータと比較され、変更があれば組織階層に適用されます。すべての読み込み操作は、組織階層の更新されたコピーに対して実行されます。保留中の変更がある場合、変更の読み込みは、階層内の保留中の変更の上に追加されます。
-
Global Admin Console にログインします。「組織」タブで、組織ピッカーを使用して、読み込みを実行する組織階層を選択します。
-
詳細オプション アイコンを選択し、「読み込み」を選択します。読み込みファイルのサイズと複雑さに応じて、処理に数秒から数分かかる場合があります。
-
「ファイルを選択」を選択し、アップロードする JSON、CSV、または XLSX ファイルを選択します。CSV の場合、一度に読み込める組織の詳細情報は 1 つだけであり、製品の読み込みはサポートされていません。
読み込まれた変更は、データを手動で編集した場合と同じ方法で表示されます。
-
「閉じる」を選択します。
-
「保留中の変更点を確認」を選択します。次に、「変更を送信」を選択して変更を実行します。
変更を実行する前に、保留中のアクションは、Global Admin Console で手動で編集した場合と同じ方法で表示されます。
書き出しと読み込みのスキーマ
CSV ファイルを使用してデータを読み込む場合、フィールドの順序は任意ですが、常にヘッダー行と一致する必要があります。
データをインポートするときは、要素ごとに操作を指定する必要があります。操作は次のいずれかです。
- Update:編集を行います。
- Create:新しいオブジェクト(組織、ユーザーグループ、管理者)を作成します。
- Delete:オブジェクト(組織、ユーザーグループ、管理者)を削除します。
操作フィールドが存在しないか空白の入力レコードは無視されます。
フィールド名 | 説明 | メモ |
---|---|---|
id | 組織 ID 新しい組織を追加する場合、このフィールドを空にするか、プレースホルダー識別子(new_org_1 など)を設定します。このプレースホルダー識別子は、他の読み込まれたエントリがこの組織を参照する必要がある場合に使用されます。作成後、実際の組織 ID が割り当てられて、使用されているすべてのプレースホルダー組織 ID が置き換えられます。 |
operation=create の場合は、一時的な値に設定できます |
name | 組織のシンプル名。4~100 の範囲で設定します。名前には最大 3 バイトの UTF-8 文字を含めることができます。4 バイト文字はサポートされていません。 |
operation=create の場合に設定でき、operation=update の場合に更新できます。 |
countryCode | 国コードまたは地域コード | operation=create の場合に設定する必要があり、operation=Update の場合に更新できます。 |
type | 組織の種類 | 読み取り専用 |
parentOrgId | 親組織 ID。ルート組織の場合は空白。 更新時には、新しい親が同じ階層にあり、組織に存在する製品を持っていることなど、重要な制限が適用されます。 |
operation=create の場合に設定でき、operation=update の場合に更新できます。 |
adminCount | 管理者数 | 読み取り専用 |
domainCount | ドメイン数 | 読み取り専用 |
userCount | ユーザー数 | 読み取り専用 |
userGroupCount | ユーザーグループ数 | 読み取り専用 |
admins | この組織の管理者を表す管理者オブジェクトのセット |
エクスポート用に選択されていない場合、存在しない可能性があります。XLSX ファイルでは、別のタブで表示されます。 |
ドメイン | この組織のドメインを表すドメインオブジェクトのセット |
|
製品 | この組織の製品を表す製品オブジェクトのセット |
|
productProfiles | この組織の製品プロファイルを表す製品プロファイルオブジェクトのセット |
|
userGroups | この組織のユーザーグループを表すユーザーグループオブジェクトのセット |
|
orgPolicies | ポリシーとその値を表す構造体 | |
operation | 空白、Create、Update、Delete のいずれか。データの読み込み時に実行するアクション。 | 書き出し時には常に空白になります。 |
読み込みの必要条件:
- 更新または削除の場合、orgId は、階層内の既存の組織を参照する必要があります。
- 新しい組織を作成する場合は、orgId フィールドを空白にするか、new-1、new-2 のように任意に作成した一意の ID に設定できます。これにより、作成される組織の参照に使用できる ID が提供されます。
- 国コードが有効である必要があります。
- Update および Delete 操作の orgId は、組織階層の中に既に存在している必要があります。
- Delete と指定された orgId を持つは、Update または Create 操作を行う組織の parentOrgId として選択しないでください。
- 同じレベルで同じ親の子組織に、同じ orgNames を指定しないでください。
- 組織を作成または組織名を更新する場合、その組織名に、同じ親の既存の子と同じ名前を使用しないでください。
フィールド名 | 説明 | 使用方法 |
---|---|---|
orgId | 管理者が所属する組織の名前。 | 包含または関連するオブジェクトを検索するための参照として使用されます。 |
firstName | 管理者ユーザーの名前(名)。 Adobe ID ユーザーの名前(名)と名前(姓)は、ユーザーが招待を受け入れる際に、ユーザーが提供した値に置き換えることができます。 |
operation=create の場合に設定でき、operation=update の場合に更新できます。 |
lastName | 管理者ユーザーの名前(姓)。 | |
管理者ユーザーのメールアドレス。これはユーザーの主キーであり、一意である必要があります。 | ||
countryCode | ユーザーが活動する国または地域のコード。Federated ID タイプと Enterprise ID タイプにのみ適用されます。 |
|
userType | 「Adobe ID」、「Enterprise ID」、「Federated ID」のいずれか。 | 読み取り専用 |
adminType | 「GLOBAL ADMIN」、「GLOBAL VIEWER」、「SYSTEM ADMIN」、「USER GROUP ADMIN」、「PRODUCT ADMIN」、「PRODUCT PROFILE ADMIN」、「DEPLOYMENT ADMIN」、「STORAGE_ADMIN」のいずれか。 | operation=Create の場合に設定可能 |
groupId | このユーザーが管理者を務めるグループのグループ ID。ユーザーグループと製品プロファイルの管理者にのみ関連します。 | |
licenseId | このユーザーが管理している製品の製品ライセンス ID。製品管理者のみに関連します。 | |
domain | メールドメインを使用していない場合のユーザーのドメイン名 | |
userName | メールアドレスを使用していない場合のユーザー名 | |
operation | 空白、Create、Update、Delete のいずれか。データの読み込み時に実行するアクション。 |
読み込みの必要条件:
- orgId、email、adminType、および userType に有効な値が含まれている必要があります。
- countryCode が有効である必要があります。
- 既存のユーザーを更新する場合は、userType がユーザーと一致している必要があります。
- 組織内に重複した電子メールアドレスがないかを確認してください。
製品プロファイルの書き出しと読み込みは、製品プロファイルの詳細情報と、製品プロファイルに関連するリソースのセットという 2 つの部分で構成されます。これらのリソースは、構成できるサービスを特定し、通常、有効または無効の値のみを持ちます。
- リソースオブジェクトは、JSON 形式で製品プロファイル内にネストされます。
- 製品プロファイルに CSV または XLSX を使用する場合、プロファイルとリソースは 1 つのテーブルにまとめられます。製品プロファイルには、リソースごとに 1 つずつ、複数のエントリがあります。
- リソースの「selected」フィールドは、サービスが有効かどうかを制御します。
- 製品プロファイルをインポートする場合、製品プロファイル自体と、更新または作成されるすべてのリソースオブジェクトに対して、作成または更新操作が必要です。
フィールド名 | 説明 | 使用方法 |
---|---|---|
productProfileId | 製品プロファイルの識別子 他のオブジェクトが新しいプロファイルを参照できるように、作成時にプレースホルダー値を使用できます。 |
operation=create の場合は、一時的な値に設定できます |
productProfileName | 製品プロファイル名:同一組織内の他の製品プロファイルまたはユーザーグループと重複した名前を指定することはできません。 |
operation=create の場合に設定でき、operation=update の場合に更新できます。 |
productProfileDescription | 製品プロファイルのテキスト説明 | |
licenseId | 製品へのライセンス ID の参照 | 包含または関連するオブジェクトを検索するための参照として使用されます。 |
orgId | 目的のユーザーグループがある組織 | |
通知 | ユーザーがこの製品プロファイルに追加または削除されたときに、メール通知を送信するかどうかを True または False で示します。 | operation=create の場合に設定でき、operation=update の場合に更新できます。 |
resources | この製品プロファイルに関連付けられたリソースの配列。 resources フィールドは、JSON 形式の場合にのみ存在します。CSV および XLSX 形式の場合、リソースは追加フィールド(resourceName、resourceId、resourceDescription、icon、selected、quota、resourceType)で表現されます。これらのフィールドについて詳しくは「製品とリソース」を参照してください。 製品プロファイルに複数のリソースがある場合は、リソースごとに 1 行ずつ、複数の行が表示されます。その他のフィールドは、各リソースに対して同じ値になります。 |
|
operation | 空白、Create、Update、Delete のいずれか。データの読み込み時に実行するアクション。 |
読み込みの必要条件:
- productProfileId、licenseId、および orgId には有効な値を指定する必要があります。
- 製品プロファイルを作成する場合、productProfileName には、同じ組織内の別の製品プロファイル名またはユーザーグループ名と重複しない有効な名前を指定する必要があります。
- quota フィールドには、ユニットタイプに対して有効な値が必要です。これは、resourceType=QUOTA の場合は数値または「unlimited」、それ以外の場合は空白です。
- 通知フィールドは true または false である必要があります。
- CSV および XLSX ファイルを読み込む場合は、productProfileId を検証します。そのすべてのエントリには、同じ orgId、licenseId、および productProfileName を設定する必要があります。
- 入力ファイルと組織で productProfileName が重複していないことを確認します。
- 更新および削除するプロファイルが、組織に存在する必要があります。
- 更新および削除(デアクティベート)するリソースが、プロファイルに存在する必要があります。
- プロファイルを作成するには、次のことを確認してください。
- orgId は新しい組織または既存の組織である必要があります。
- licenseId は、新しい製品または既存の製品である必要があります。
- プロファイルのリソースを検証します。
製品プロファイルのリソース:
フィールド名 | 説明 | 使用方法 |
---|---|---|
resourceName | リソース名 | 読み取り専用 |
resourceId | リソースの ID | 読み取り専用 |
resourceDescription | リソースのテキスト説明 | 読み取り専用 |
アイコン | リソース画像への URL | 読み取り専用 |
選択しました | 構成エントリの場合、機能が有効かどうかを指定します。このフィールドは JSON にのみ存在します。 |
operation=create の場合に設定でき、operation=update の場合に更新できます。 |
quota | この製品プロファイルを介してユーザーに提供できる主要リソースの容量。このフィールドは JSON にのみ存在します。 |
|
resourceType | 存在する場合、値は SERVICE です。これは、このリソースが、選択したフィールドの値に基づいて有効または無効にできるサービスを表していることを示します。このフィールドは JSON にのみ存在します。 |
読み取り専用 |
operation | 空白、Create、Update、Delete のいずれか。データの読み込み時に実行するアクション。 |
読み込みの必要条件:
リソースの Operation フィールドは、リソースが属する製品プロファイルの操作が Delete または Create に設定されている場合は無視されます。
- リソースを削除するようにマークしないでください。マークした場合、無効な操作となります。
- 製品プロファイルを作成する場合、リソースの数はソース製品プロファイルのリソースの数と一致する必要があります。
- Update 操作のリソースの場合、そのリソースが製品プロファイルに存在する必要があります。
フィールド名 | 説明 | 使用方法 |
---|---|---|
userGroupId | ユーザーグループの ID 他のオブジェクトが新しいユーザーグループを参照できるように、作成時にプレースホルダー値を使用できます。 |
operation=create の場合は、一時的な値に設定できます |
userGroupName | ユーザーグループ名 | operation=create の場合に設定でき、operation=update の場合に更新できます。 |
userGroupDescription | ユーザーグループのテキスト説明 | |
userCount | ユーザーグループのユーザー数 | 読み取り専用 |
プロファイル | ユーザーグループが関連付けられている製品プロファイル ID の配列。 XLSX には、他のフィールドに同じ値を持つ値ごとに 1 行が当てられます。 |
operation=create の場合に設定でき、operation=update の場合に更新できます。 |
orgId | 目的のユーザーグループがある組織 | 包含または関連するオブジェクトを検索するための参照として使用されます。 |
operation | 空白、Create、Update、Delete のいずれか。データの読み込み時に実行するアクション。 |
読み込みの必要条件:
- orgId は、既存の組織、または同じ読み込みで作成される組織を参照する必要があります。
- userGroupId は、更新または削除する既存のグループを参照する必要があります。新しいユーザーグループ用に定義した ID を使用することもできます。
- 更新または作成の場合、userGroupNameorganization を空白にすることはできません。また同じ組織内の他のユーザーグループまたは製品プロファイル名と重複していないことを確認してください。
- 入力ファイルと組織で userGroupName が重複していないことを確認してください。
- 更新および削除する userGroups が、組織に存在する必要があります。
- ユーザーグループから削除するプロファイルが、ユーザーグループに存在する必要があります。ユーザーグループのプロファイルに対して更新操作を実行することはできません。
- ユーザーグループを作成するには、次のことを確認してください。
- orgId は新しい組織または既存の組織である必要があります。
- licenseId(該当する場合)は、新しい製品または既存の製品である必要があります。
- productProfileId には、新しい製品プロファイルまたは既存の製品プロファイルを指定する必要があります。
ドメイン情報には、各組織で使用可能なドメインに関する読み取り専用の情報を提供します。このデータは編集できません。
フィールド名 |
説明 |
使用方法 |
---|---|---|
orgId |
このドメインがリストされている組織への参照 |
包含または関連するオブジェクトを検索するための参照として使用されます。 |
domainName |
ドメイン名(adobe.com など)。 |
読み取り専用 |
directoryName |
ドメインがリストされているディレクトリの名前 |
読み取り専用 |
directoryType |
Federated ID または Enterprise ID のいずれか。 |
読み取り専用 |
domainStatus |
「ACTIVE」、「RESERVED」、「UNCLAIMED」、「CLAIMED」、「VALIDATED」、「WITHDRAWN」、「ACTIVE」、「EXPIRED」のいずれか。 |
読み取り専用 |
XLSX ファイルには、製品用とリソース用の 2 つのシートがあります。JSON では、リソースオブジェクトは製品オブジェクトにネストされます。
製品:
フィールド名 | 説明 | 使用方法 |
---|---|---|
licenseId | 製品を識別するための ID。各製品には、その製品がリストされている組織で、固有のライセンス ID があります。 同じ製品のライセンス ID は、組織によって異なります。新しい製品を追加する場合は、空にするか、プレースホルダー識別子(new_product_1 など)を使用します。プレースホルダー ID は、他のインポートされたエントリがこの製品インスタンスを参照する必要がある場合に使用されます。作成後、実際のライセンス ID が割り当てられ、使用されているすべてのプレースホルダーライセンス ID が置き換えられます。 |
operation=create の場合は、一時的な値に設定できます |
productName | 製品の名前 | 読み取り専用 |
productDescription | 製品のテキスト説明 | 読み取り専用 |
allowOverallocation | この製品インスタンスの割り当て超過を許可するかどうかを示すブール値。 割り当て超過とは、付与されているよりも多くの数量を子組織に付与できることを指します。 |
operation=create の場合に設定でき、operation=update の場合に更新できます。 |
アイコン | 製品アイコンの URL | 読み取り専用 |
sourceLicenseId | この製品の割り当て元となった組織の製品インスタンスのライセンス ID。このインスタンスが割り当てられた製品ではなく、購入した製品である場合、値は null です。 | operation=Create の場合に設定可能 |
productId | 製品の ID。 | 読み取り専用 |
orgId | この製品インスタンスが含まれている組織の識別子 | 包含または関連するオブジェクトを検索するための参照として使用されます。 |
redistributable | この製品に子組織に付与できるリソースがあるかどうかを示すブール値。 | 読み取り専用 |
resources | この製品のリソースと設定を表すリソースオブジェクトのセットが含まれているオブジェクト | |
operation | 空白、Create、Update、Delete のいずれか。データの読み込み時に実行するアクション。 |
読み込みの必要条件:
- create の場合、licenseId には作成する一意の ID を設定する必要があります。
- update の場合、licenseId には、指定された組織内の既存の製品の ID を設定する必要があります。
- orgId は、既存の組織、または同じ読み込み操作で作成される組織を参照する必要があります。
- 作成の場合、sourceLicenseId は、既存の製品、または同じインポート操作で作成される製品に対して定義した ID を参照する必要があります。
- licenseId と sourceLicenseId は、Create オペレーションを使用する製品では同じ値に設定することはできません。
- 製品の組織を確認してください。組織には新しい組織か、組織階層に既に存在している組織を指定する必要があります。
- Update および Delete 操作では、製品が組織階層の中に既に存在している必要があります。
- Delete としてマークされた licenseId は、Create および Update 操作で製品の sourceLicenseId として使用しないでください。
- Create 操作を行う製品では、sourceLicenseId が親組織に存在する必要があることを検証します。
製品のリソース:
リソースオブジェクトは、製品および製品プロファイルに表示できます。
フィールド名 | 説明 | 使用方法 |
---|---|---|
resourceName | リソース名 | 読み取り専用 |
resourceId | リソースの ID | 読み取り専用 |
resourceDescription | リソースのテキスト説明 | 読み取り専用 |
アイコン | リソース画像への URL | 読み取り専用 |
productName | このリソースが含まれている製品の名前。 | 読み取り専用 |
licenseId | このリソースが含まれている製品のライセンス ID(製品インスタンス)。 | 包含または関連するオブジェクトを検索するための参照として使用されます。 |
grantedQuantity | このリソースの付与量:この組織がローカルで使用したり、子組織に割り当てたりできるリソースの量。 | operation=create の場合に設定でき、operation=update の場合に更新できます。 |
unit | 付与量の単位名。 | 読み取り専用 |
currentQuantity | この組織で現在使用可能な数量。これは、grantedQuantity から子組織に割り当てられたリソースを差し引いた量です。この値は、この製品またはリソースについて、Admin Console に表示されます。 | 読み取り専用 |
provisionedQuantity | 実際にプロビジョニングされた数量:付与された量または現在の量よりも少ない可能性があり、何らかの制限がある場合は currentQuantity よりも少ない可能性があります。 | 読み取り専用 |
operation | 空白、Create、Update、Delete のいずれか。データの読み込み時に実行するアクション。 |
読み込みの必要条件:
リソースの Operation フィールドは、リソースが属する製品の操作が Delete または Create に設定されている場合は無視されます。
- リソースを削除するようにマークしないでください。マークした場合、無効な操作となります。
- 製品を作成する場合、リソースの数はソース製品のリソースの数と一致する必要があります。
- Update 操作を行うリソースの場合、そのリソースが製品に存在する必要があります。
製品割り当てデータの読み込みと書き出し
グローバル管理者は、製品割り当てデータを JSON または CSV ファイルとして書き出しできます。次に、そのデータを操作してからアップロードし直し、変更を読み込むことができます。 変更された可能性のあるデータがアップロードされると、新しいデータが現在のデータと比較され、変更が製品割り当てデータに適用されます。次に、保留中の変更を確認して送信し、変更を有効にすることができます。
製品割り当てモデルの書き出し
製品割り当てモデルを書き出すには、次の手順を実行します。
- Global Admin Console にログインし、「製品の割り当て」タブに移動します。
- 詳細オプション アイコンを選択し、「CSV の書き出し」または「JSON の書き出し」を選択します。ファイルがダウンロードされます。書き出し形式について詳しくはこちらを参照してください。
製品割り当てモデルの読み込み
データを書き出して変更し、変更したファイルを読み込むことができます。製品割り当てモデルを読み込むには、次の手順を実行します。
- Global Admin Console にログインし、「製品の割り当て」タブに移動します。
- 詳細オプション アイコンを選択し、「読み込み」を選択します。
- 読み込む JSON または CSV ファイルを選択します。
- 「保留中の変更点を確認」を選択します。 変更内容を確認した後、「変更を送信」を選択してそれらの変更を実行します。
製品割り当ての読み込みと書き出しの形式
読み込みの形式と書き出しの形式は同じです。CSV 形式で読み込む場合、フィールドの順序は任意ですが、常にヘッダー行と一致する必要があります。JSON 形式で読み込んでいる場合は、フィールドは任意の順序で表示できます。
製品割り当てデータを読み込んでいるときは、操作を指定する必要があります。操作は次のいずれかです。
- アップデート:編集を示します(grantedQuantity 値、allowOverAllocation 値への変更)。
- 作成:指定された組織に製品リソースを追加することを示します。
- 削除:製品の削除を示します。
操作が指定されていない場合、CSV のその行または JSON のオブジェクトのデータが読み込まれても、変更は実行されません。
書き出されたファイルには、製品リソースごとに 1 つの行またはレコードがあります。一部の製品には複数のリソースがあります。
製品に複数のリソースがある場合、アップデート操作は独立したリソースに適用できます。削除操作では、組織からすべてのリソースを含む製品が削除されます。作成操作では、インポートファイル内の各リソースのレコードが必要です。これにより、各リソースの適切な数量を指定できます。「allowOverAllocation」フィールドは、製品全体に対するもので、このフィールドのアップデートがどのリソースのものであるかは関係ありません。
フィールド名 | 説明 | 使用方法 |
---|---|---|
productName | 製品の名前。例えば、コンプリートプラン。 | 読み取り専用 |
licenseId | 製品の ID(組織内の製品に固有)。 新しい製品を追加する場合は、空にするか、プレースホルダー識別子(new_product_1 など)を設定します。このプレースホルダー識別子は、他の読み込まれたエントリがこの製品を参照する必要がある場合に使用されます。作成後、実際のライセンス ID が割り当てられて、使用されているすべてのプレースホルダーライセンス ID が置き換えられます。 |
operation=Create の場合に設定可能 |
sourceLicenseId | 親製品の ID。これが割り当てではなく購入を表す場合は、空または null です。 | operation=Create の場合に設定可能 |
productId | この製品クラスを識別する ID。この ID は同じタイプの製品間で共有され、この製品のインスタンスを識別する licenseId とは異なります。 | 読み取り専用 |
resourceName | この製品リソースの名前。例えば、ユーザー指定ライセンス。 | 読み取り専用 |
resourceId | この製品リソースを識別する ID。 | operation=Create の場合に設定可能 |
orgPathName | この製品リソースが属する組織のパス名。「/」で区切られたセグメント。 | 読み取り専用 |
orgName | この製品リソースを含む組織のシンプル名。これは orgPathName の最後のセグメントです。 | 読み取り専用 |
orgId | この製品リソースを含む組織の組織 ID。 | operation=Create の場合に設定可能 |
grantedQuantity | 親によってこの組織に付与されたリソース数量の単位数、またはこの製品リソースエントリが購入を表す場合は購入金額。 このフィールドは、グローバル管理者が変更する権限を持たない購入済みの製品またはルート割り当てを除いて、更新可能です。 |
operation=Update の場合に更新可能 のときに operation=Create |
unit | リソース単位の名前。例えば、ユーザー。 | 読み取り専用 |
totalAllocations | この製品リソースに対する、この組織から子組織への付与の合計。この値には、直接の子への直接の付与と、それらの組織からの割り当て超過が含まれます。例えば、この組織が子に 10 を付与し、子がその子に 25 を割り当てた場合、totalAllocations は 25 になります。つまり、子に付与された 10 と、その子の超過分の 15 の合計です。 | 読み取り専用 |
grantOverage | totalAllocations が grantedQuantity を超える量。totalAllocations が grantedQuantity を超えない場合、この値は null またはゼロです。 | 読み取り専用 |
localLicensedQuantity | この組織に付与されたこのリソースの量は、子に割り当てられた量が差し引かれた後、その組織での使用のために残されます。これは Admin Console に表示される量です。この値はゼロにすることができますが、この組織がその子にリソースを過剰に割り当てている場合でも、負の値になることはありません。 | 読み取り専用 |
localUsage | この組織で使用されているリソースの単位数。例えば、ユーザー指定ライセンスをユーザーに委任すると、1 使用単位としてカウントされます。 | 読み取り専用 |
totalUsage | この組織と子で使用されているリソースの単位数。これは、この組織にルートされた組織階層の一部での、このリソースの使用を示しています。 | 読み取り専用 |
useOverage | 組織の付与を超える合計使用量(組織と子は、使用可能なリソースよりも多くのリソースを使用しています)。totalUsage が localLicensedQuantity を超えると、これはゼロ以外の値を示します。 | 読み取り専用 |
allowOverAllocation | 付与するリソースがなくなった場合でも、ユーザーが子にさらにリソースを付与できる(付与が超過していても付与が可能)かどうかを示します。この値は、この製品のすべてのリソースに適用されます。同じ製品の複数のリソースの allowOverallocation を異なる値に更新しようとすると、結果はランダムになります。 | operation=Update の場合に更新可能 |
isPurchasedProduct | 製品が購入製品(親によって割り当てられていない)の場合は、true。これは、値が空の sourceLicenseId と同等です。 | 読み取り専用 |
redistributable | 製品を子に割り当てることができる場合は true、製品が表示されている組織でのみ使用可能であり、リソースを別の組織に割り当てることができない場合は、false です。 | 読み取り専用 |
operation | 空白、Create、Update、Delete のいずれか。データの読み込み時に実行するアクション。 |
データ検証
- 操作フィールドには有効な操作が必要です。
- 製品のインポートデータには、必須フィールドのプロパティと値が必要です。
- 製品のインポートデータのプロパティは正しいタイプである必要があります。
- 製品ポリシーフィールド(overAllocation)は、異なるリソースには提供できません。
- grantedQuantity フィールド:
- 無制限になっていない場合は、無制限に変更することはできません。
- 負でない整数または文字列値 unlimited である必要があります。
権限/アクセス可能な検証
- インポートデータに関連付けられている組織が存在している必要があります。更新する場合は、インポートデータに関連付けられている製品とリソースが実際に存在することを確認してください。
製品検証の追加
- SourceLicenseId が存在する必要があります。
- 新しい製品に関連付けられている組織が存在している必要があります。
- 作成中の製品(同じ licenseId を持つ製品)が存在することはできません。
- 作成中の製品に関連付けられているリソースには、その製品と一致する対応する productId が必要です。