ドメインリソースの種類domain resource type

テナントに関連付けられているドメインを表します。Represents a domain associated with the tenant.

ドメインの操作を使用して、ドメインをテナントに関連付け、ドメインの所有権を確認し、サポートされているサービスを構成します。Use domain operations to associate domains to a tenant, verify domain ownership, and configure supported services. ドメイン操作によって Office 365 などのサービスのドメインの関連付けを自動化するレジストラーを有効にします。Domain operations enable registrars to automate domain association for services such as Office 365. たとえば、ドメインのサインアップの一環として、レジストラーは、電子メール、web サイト、認証などのバニティドメインを有効にすることができます。For example, as part of domain sign up, a registrar can enable a vanity domain for email, websites, authentication, etc.

ドメインをテナントに関連付けるには、次のようにします。To associate a domain with a tenant:

  1. ドメインをテナントに関連付けます。Associate a domain with a tenant.

  2. ドメイン検証レコードを取得します。Retrieve the domain verification records. ドメインレジストラーまたは DNS サーバー構成を使用して、ドメインのゾーンファイルに検証レコードの詳細を追加します。Add the verification record details to the domain's zone file using the domain registrar or DNS server configuration.

  3. ドメインの所有権を確認します。Verify the ownership of the domain. これにより、ドメインが確認さ** れ、isverified プロパティがtrueに設定されます。This will verify the domain and set the isVerified property to true.

  4. ドメインでの使用を計画しているサービスを示します。Indicate the supported services you plan to use with the domain.

  5. ドメインのサービスを有効にするために必要なレコードの一覧を取得して、サポートされているサービスを構成します。Configure supported services by retrieving a list of records needed to enable services for the domain. ドメインレジストラーまたは DNS サーバー構成を使用して、ドメインのゾーンファイルに構成レコードの詳細を追加します。Add the configuration record details to the domain's zone file using the domain registrar or DNS server configuration.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
ドメインを取得するGet domain domaindomain ドメインオブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of a domain object.
ドメインを作成するCreate domain domaindomain テナントにドメインを追加します。Adds a domain to the tenant.
リスト domainNameReferenceList domainNameReference directoryObject collectiondirectoryObject collection ドメインへの参照を使用して、ディレクトリオブジェクトの一覧を取得します。Retrieve a list of directory objects with a reference to the domain.
リスト serviceConfigurationRecordsList serviceConfigurationRecords DomaindnsrecordコレクションdomainDnsRecord collection ドメイン構成のドメイン DNS レコードの一覧を取得します。Retrieve a list of domain DNS records for domain configuration.
リスト verificationDnsRecordsList verificationDnsRecords DomaindnsrecordコレクションdomainDnsRecord collection ドメイン検証のドメイン DNS レコードの一覧を取得します。Retrieve a list of domain DNS records for domain verification.
ドメインを更新するUpdate domain domaindomain ドメインを更新します。Updates a domain.
ドメインを削除するDelete domain NoneNone ドメインを削除します。Deletes a domain.
ForceDelete ドメインForceDelete domain NoneNone 非同期操作を使用してドメインを削除します。Deletes a domain using an asynchronous operation.
ドメインを確認するVerify domain domaindomain ドメインの所有権を検証します。Validates the ownership of the domain.

プロパティProperties

プロパティProperty Type 説明Description
authenticationTypeauthenticationType StringString ドメインに対して構成されている認証の種類を示します。Indicates the configured authentication type for the domain. 値は、管理されているか、フェデレーションされています。The value is either Managed or Federated.
Managedは、Azure AD がユーザー認証を実行するクラウド管理のドメインを示します。Managed indicates a cloud managed domain where Azure AD performs user authentication.
フェデレーションは、Active Directory フェデレーションサービスを経由して、テナントの社内 Active directory などの id プロバイダーとの認証がフェデレーションされることを示します。Federated indicates authentication is federated with an identity provider such as the tenant's on-premises Active Directory via Active Directory Federation Services. このプロパティは値の取得のみ可能で、null 許容ではありません。This property is read-only and is not nullable.
availabilityStatusavailabilityStatus StringString Verifyアクションが使用される場合を除き、このプロパティは常に null になります。This property is always null except when the verify action is used. Verifyアクションを使用すると、応答でドメインエンティティが返されます。When the verify action is used, a domain entity is returned in the response. 応答内のドメインエンティティのavailabilityStatusプロパティは、すぐに、またはEmailVerifiedDomainTakeoverScheduledでもかまいません。The availabilityStatus property of the domain entity in the response is either AvailableImmediately or EmailVerifiedDomainTakeoverScheduled.
idid StringString ドメインの完全修飾名。The fully qualified name of the domain. キー、不変、null 許容ではない、uniqueKey, immutable, not nullable, unique
isAdminManagedisAdminManaged BooleanBoolean ドメインの DNS レコード管理が Office 365 に委任されている場合、このプロパティの値は false になります。The value of the property is false if the DNS record management of the domain has been delegated to Office 365. それ以外の場合、値は true になります。Otherwise, the value is true. Null 許容ではないNot nullable
isDefaultisDefault ブール型 (Boolean)Boolean これがユーザーの作成に使用される既定のドメインの場合は True。True if this is the default domain that is used for user creation. 会社ごとに既定のドメインが1つだけ存在します。There is only one default domain per company. Null 許容ではないNot nullable
isInitialisInitial ブール値Boolean True は、Microsoft Online Services (companyname.onmicrosoft.com) によって作成された初期ドメインの場合です。True if this is the initial domain created by Microsoft Online Services (companyname.onmicrosoft.com). 会社ごとに1つの初期ドメインのみが存在します。There is only one initial domain per company. Null 許容ではないNot nullable
isRootisRoot BooleanBoolean ドメインが確認されたルートドメインの場合は True。True if the domain is a verified root domain. それ以外の場合は、ドメインがサブドメインまたは未確認の場合は false。Otherwise, false if the domain is a subdomain or unverified. Null 許容ではないNot nullable
isVerifiedisVerified BooleanBoolean ドメインの所有権の確認が完了した場合は True。True if the domain has completed domain ownership verification. Null 許容ではないNot nullable
passwordNotificationWindowInDayspasswordNotificationWindowInDays Int32Int32 ユーザーがパスワードの有効期限が切れると通知を受信するまでの日数を指定します。Specifies the number of days before a user receives notification that their password will expire. このプロパティが設定されていない場合は、既定値の14日が使用されます。If the property is not set, a default value of 14 days will be used.
passwordValidityPeriodInDayspasswordValidityPeriodInDays Int32Int32 パスワードを変更するまでの有効期間を指定します。Specifies the length of time that a password is valid before it must be changed. このプロパティが設定されていない場合は、既定値の90日が使用されます。If the property is not set, a default value of 90 days will be used.
supportedServicessupportedServices 文字列コレクションString collection ドメインに割り当てられている機能。The capabilities assigned to the domain.

0、1または次の値を含めることができます。 EmailSharepointemailinternalrelayonlyOfficeCommunicationsOnlinesharepointdefaultdomainfullredelegationsharepointpublicOrgidauthenticationYammerIntuneCan include 0, 1 or more of following values: Email, Sharepoint, EmailInternalRelayOnly, OfficeCommunicationsOnline, SharePointDefaultDomain, FullRedelegation, SharePointPublic, OrgIdAuthentication, Yammer, Intune

Graph API を使用して追加または削除できる値は次のとおりです。 EmailOfficeCommunicationsOnlineYammerThe values which you can add/remove using Graph API include: Email, OfficeCommunicationsOnline, Yammer
Null 許容ではないNot nullable
statestate domainStatedomainState ドメインに対してスケジュールされた非同期操作の状態。Status of asynchronous operations scheduled for the domain.

リレーションシップRelationships

確認レコードやサービス構成レコードなど、ディレクトリ内のドメインとその他のオブジェクトとの関係は、ナビゲーションプロパティを通じて公開されます。Relationships between a domain and other objects in the directory such as its verification records and service configuration records are exposed through navigation properties. これらのリレーションシップは、要求でこれらのナビゲーションプロパティを対象にして確認できます。You can read these relationships by targeting these navigation properties in your requests.

リレーションシップRelationship Type 説明Description
domainNameReferencesdomainNameReferences directoryObject collectiondirectoryObject collection 読み取り専用、Null 許容Read-only, Nullable
serviceConfigurationRecordsserviceConfigurationRecords DomaindnsrecordコレクションdomainDnsRecord collection DNS レコードユーザーが Microsoft Online services で使用できるようになる前に、ドメインの DNS ゾーンファイルに追加されます。DNS records the customer adds to the DNS zone file of the domain before the domain can be used by Microsoft Online services.
読み取り専用、Null 許容Read-only, Nullable
verificationDnsRecordsverificationDnsRecords DomaindnsrecordコレクションdomainDnsRecord collection お客様が Azure AD を使用してドメインの所有権の確認を完了する前に、お客様がドメインの DNS ゾーンファイルに追加する DNS レコード。DNS records that the customer adds to the DNS zone file of the domain before the customer can complete domain ownership verification with Azure AD.
読み取り専用、Null 許容Read-only, Nullable

JSON 表記JSON representation

以下は、リソースの JSON 表記です。Here is a JSON representation of the resource.

{
  "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"]
}