ドメイン リソースの種類

名前空間: microsoft.graph

テナントに関連付けられているドメインを表します。

ドメイン操作を使用して、ドメインをテナントに関連付け、ドメインの所有権を確認し、サポートされているサービスを構成します。 ドメイン操作によって Office 365 などといったサービスでのドメインの関連付けを自動化するレジストラーを有効にします。 たとえば、ドメインサインアップの一環として、レジストラーは電子メール、Web サイト、認証などのバニティ ドメインを有効にすることができます。

ドメインをテナントに関連付けるには:

1. ドメインをテナントに関連付けます。

2. ドメイン検証レコードを取得します。 ドメイン レジストラーまたは DNS サーバー構成を使用して、検証レコードの詳細をドメインのゾーン ファイルに追加します。

3. ドメインの所有権を確認します。 これにより、ドメインが検証され、 isVerified プロパティ trueが .

4. ドメインで使用する予定のサポートされているサービスを示します。

5. ドメインのサービスを有効にするために必要なレコードの一覧を取得して、サポートされているサービスを構成します。 ドメイン レジストラーまたは DNS サーバー構成を使用して、構成レコードの詳細をドメインのゾーン ファイルに追加します。

メソッド

メソッド	戻り値の型	説明
ドメインを取得する	domain	ドメイン オブジェクトのプロパティとリレーションシップを読み取ります。
ドメインを作成する	domain	テナントにドメインを追加します。
ドメインを一覧表示する	domain	テナントにリンクされているすべてのドメインを取得します。
domainNameReference を一覧表示する	directoryObject コレクション	ドメインへの参照を持つディレクトリ オブジェクトの一覧を取得します。
ServiceConfigurationRecords を一覧表示する	domainDnsRecord コレクション	ドメイン構成のドメイン DNS レコードの一覧を取得します。
verificationDnsRecords を一覧表示する	domainDnsRecord コレクション	ドメイン検証用のドメイン DNS レコードの一覧を取得します。
ドメインを更新する	domain	ドメインを更新します。
ドメインを削除する	None	ドメインを削除します。
ForceDelete ドメイン	なし	非同期操作を使用してドメインを削除します。
ドメインを確認する	domain	ドメインの所有権を検証します。

プロパティ

プロパティ	型	説明
authenticationType	String	ドメインに対して構成されている認証の種類を示します。 値は次のいずれか Managed または Federated. Managed は、Azure AD がユーザー認証を実行するクラウド マネージド ドメインを示します。 Federatedは、認証がActive Directory フェデレーション サービス (AD FS)経由でテナントのオンプレミスの Active Directoryなどの ID プロバイダーとフェデレーションされていることを示します。 このプロパティは読み取り専用であり、null 許容ではありません。
availabilityStatus	String	このプロパティは、検証アクションが使用されている場合を除き、常にnull使用されます。 検証アクションが使用されると、応答で ドメイン エンティティが返されます。 応答内の ドメイン エンティティの availabilityStatus プロパティは、次のいずれかAvailableImmediatelyですEmailVerifiedDomainTakeoverScheduled。
id	String	ドメインの完全修飾名。 Key、immutable、not nullable、unique。
isAdminManaged	ブール型	プロパティの値は、 false ドメインの DNS レコード管理が Microsoft 365 に委任されている場合です。 それ以外の場合、値は true. null 許容ではない
isDefault	ブール型 (Boolean)	true これがユーザー作成に使用される既定のドメインの場合。 会社ごとに既定のドメインは 1 つだけです。 null 許容ではない
isInitial	ブール値	true これが Microsoft Online Services (companyname.onmicrosoft.com) によって作成された初期ドメインの場合。 会社ごとに最初のドメインは 1 つだけです。 null 許容ではない
isRoot	ブール値	true ドメインが検証済みのルート ドメインの場合。 それ以外の場合は、 false ドメインがサブドメインまたは未検証の場合。 null 許容ではない
isVerified	ブール型	true ドメインがドメイン所有権の検証を完了した場合。 null 許容ではない
passwordNotificationWindowInDays	Int32	ユーザーがパスワードの有効期限が切れるという通知を受け取るまでの日数を指定します。 プロパティが設定されていない場合は、既定値の 14 日間が使用されます。
passwordValidityPeriodInDays	Int32	パスワードを変更する前に有効な時間を指定します。 プロパティが設定されていない場合は、既定値の 90 日間が使用されます。
supportedServices	String collection	ドメインに割り当てられている機能。 次の値を含0めることができます。 Email, , EmailInternalRelayOnly``Sharepoint, OfficeCommunicationsOnline``SharePointDefaultDomain, FullRedelegation, SharePointPublic, OrgIdAuthentication, Yammer``Intune. 1 Graph APIを使用して追加/削除できる値は次のとおりです。 Email``OfficeCommunicationsOnline``Yammer null 許容ではありません。
state	domainState	ドメインに対してスケジュールされた非同期操作の状態。

リレーションシップ

ドメインとその検証レコードやサービス構成レコードなどのディレクトリ内の他のオブジェクト間のリレーションシップは、ナビゲーション プロパティを使用して公開されます。 要求でこれらのナビゲーション プロパティをターゲットにすることで、これらのリレーションシップを読み取ることができます。

リレーションシップ	型	説明
domainNameReferences	directoryObject コレクション	ドメイン ID を参照するユーザーやグループなどのオブジェクト。 読み取り専用、Null 許容。 返されるオブジェクトの OData 型をサポート $expand します $filter 。 たとえば /domains/{domainId}/domainNameReferences/microsoft.graph.user 、 /domains/{domainId}/domainNameReferences/microsoft.graph.group.
serviceConfigurationRecords	domainDnsRecord コレクション	ドメインを Microsoft Online サービスで使用する前に、顧客がドメインの DNS ゾーン ファイルに追加した DNS レコード。 読み取り専用、Null 許容。 $expand をサポートします。
verificationDnsRecords	domainDnsRecord コレクション	顧客が Azure AD でドメイン所有権の検証を完了する前に、顧客がドメインの DNS ゾーン ファイルに追加した DNS レコード。 読み取り専用、Null 許容。 $expand をサポートします。
federationConfiguration	internalDomainFederation	Azure AD とのフェデレーション時に顧客によって構成されたドメイン設定。 $expand をサポートします。

JSON 表記

以下は、リソースの JSON 表記です。

{
  "authenticationType": "String",
  "availabilityStatus": "String",
  "id": "String (identifier)",
  "isAdminManaged": true,
  "isDefault": true,
  "isInitial": true,
  "isRoot": true,
  "isVerified": true,
  "passwordNotificationWindowInDays": 14,
  "passwordValidityPeriodInDays": 90,
  "state": {"@odata.type": "microsoft.graph.domainState"},
  "supportedServices": ["String"]
}