リストの検証DnsRecords
[アーティクル]
01/21/2022
3 人の共同作成者
この記事の内容
名前空間: microsoft.graph
domainDnsRecord オブジェクトの一覧を取得 します。
所有権が確認されるまで、関連付けられたドメインをAzure ADテナントに使用することはできません。 ドメインの所有権を確認するには、ドメイン検証レコードを取得し、ドメインのゾーン ファイルに詳細を追加します。 これは、ドメイン レジストラーまたは DNS サーバー構成を使用して実行できます。
ルート ドメインには検証が必要です。 たとえば、検証 contoso.com 必要があります。 ルート ドメインが確認された場合、ルート ドメインのサブドメインが自動的に検証されます。 たとえば、subdomain.contoso.com が検証された場合、contoso.com 自動的に確認されます。
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可 」を参照してください。
アクセス許可の種類
アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)
Domain.Read.All、Domain.ReadWrite.All
委任 (個人用 Microsoft アカウント)
サポートされていません。
アプリケーション
Domain.Read.All、Domain.ReadWrite.All
HTTP 要求
GET /domains/{id}/verificationDnsRecords
{Id} には、ドメインを完全修飾ドメイン名で指定します。
オプションのクエリ パラメーター
このメソッドは、応答をカスタマイズするための OData クエリ パラメーター をサポートします。
名前
説明
Authorization
ベアラー {token}。必須。
Content-Type
application/json
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは応答コードと、応答本文の 200 OK domainDnsRecord オブジェクトのコレクションを返します。
例
要求
GET https://graph.microsoft.com/v1.0/domains/{domain-name}/verificationDnsRecords
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
var verificationDnsRecords = await graphClient.Domains["{domain-id}"].VerificationDnsRecords
.Request()
.GetAsync();
SDK をプロジェクトに追加し、authProvider インスタンスを作成する 方法の詳細については、SDK のドキュメントを参照してください 。
const options = {
authProvider,
};
const client = Client.init(options);
let verificationDnsRecords = await client.api('/domains/{domain-name}/verificationDnsRecords')
.get();
SDK をプロジェクトに追加し、authProvider インスタンスを作成する 方法の詳細については、SDK のドキュメントを参照してください 。
MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/domains/{domain-name}/verificationDnsRecords"]]];
[urlRequest setHTTPMethod:@"GET"];
MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest
completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {
NSError *jsonError = nil;
MSCollection *collection = [[MSCollection alloc] initWithData:data error:&jsonError];
MSGraphDomainDnsRecord *domainDnsRecord = [[MSGraphDomainDnsRecord alloc] initWithDictionary:[[collection value] objectAtIndex: 0] error:&nserror];
}];
[meDataTask execute];
SDK をプロジェクトに追加し、authProvider インスタンスを作成する 方法の詳細については、SDK のドキュメントを参照してください 。
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
DomainDnsRecordCollectionPage verificationDnsRecords = graphClient.domains("{domain-name}").verificationDnsRecords()
.buildRequest()
.get();
SDK をプロジェクトに追加し、authProvider インスタンスを作成する 方法の詳細については、SDK のドキュメントを参照してください 。
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)
domainId := "domain-id"
result, err := graphClient.DomainsById(&domainId).VerificationDnsRecords().Get()
SDK をプロジェクトに追加し、authProvider インスタンスを作成する 方法の詳細については、SDK のドキュメントを参照してください 。
応答
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"isOptional": false,
"label": "contoso.com",
"recordType": "Mx",
"supportedService": "Email",
"ttl": 3600,
"id": "id-value"
}
]
}