Domain Names:統合の概要

OpenAPI の概要

Alibaba Cloud は、API 検索、ドキュメント、オンラインデバッグ、SDK 生成、サンプルコード、呼び出し診断、統計を統合したプラットフォームである OpenAPI Explorer を提供しています。OpenAPI Explorer は SDK サンプルコードも生成し、開発を迅速に開始できるよう支援します。詳細については、「OpenAPI とは」をご参照ください。

バージョン

Alibaba Cloud OpenAPI は、製品のメジャーリリースごとに API を管理するためにバージョン番号を使用します。Domain Names は現在、API バージョン 2018-01-29 をサポートしています。この値はバージョン識別子であり、日付ではありません。常に最新の公開 API データへのアクセスを提供し、API は 2018-01-29 以降に更新されている可能性があります。

オンラインデバッグ

API を呼び出すには、そのバージョン、エンドポイント、スタイル、およびサポートされている呼び出し方法を把握している必要があります。

たとえば、SaveSingleTaskForCreatingOrderActivate (ドメイン登録タスクを送信) API を使用するには、OpenAPI Explorer の左側メニューで対象の API を選択します。中央のエリアで、China (Hangzhou) などのエンドポイントを選択し、リクエストパラメーターを入力します。これらのパラメーターには、必須の DomainName (登録するドメイン)、SubscriptionDuration (購入期間)、RegistrantProfileId (ドメインプロファイル ID)、EnableDomainProxy (ドメインプライバシー保護を有効にするかどうか)、PermitPremiumActivation (プレミアムドメインの登録を許可するかどうか) が含まれます。次に、[Submit Request] をクリックします。API の説明とリクエストパラメーターのドキュメントは、右側のパネルで確認できます。

デバッグのエントリポイント

デバッグページは次のリンクからアクセスできます： Domain Names API のデバッグページ。

エンドポイント

レイテンシーを最小限に抑えるため、リソースが配置されているリージョンのエンドポイントを選択してください。

Singapore のエンドポイント： domain-intl.aliyuncs.com。

API スタイル

RPC スタイル。

アイデンティティ

デフォルトでは、OpenAPI Explorer は API 呼び出しに Alibaba Cloud アカウントのアイデンティティを使用します。このアカウントは完全な API アクセス権を持つため、API アクセスと日常業務のために RAM ユーザーを作成することを強く推奨します。API 呼び出しを行う前に、RAM ユーザーに必要な Domain Names 権限を付与してください。詳細については、「Domain Names 操作を実行するための RAM ユーザーの作成」をご参照ください。

詳細情報

• アイデンティティ、認証情報、認可

• スロットリングとクォータ管理

統合方法

• Alibaba Cloud SDK

  • Alibaba Cloud は、Java、C#、Go、Python、Node.js/TypeScript、PHP、C++ 用の SDK を提供しています。これらの SDK は署名ロジック、タイムアウト処理、リトライロジックをカプセル化し、Request オブジェクトと Response オブジェクトを提供して開発を簡素化します。詳細については、「Alibaba Cloud SDK」をご参照ください。

  • Domain Names SDK を使用して OpenAPI を呼び出すことができます。サポートされている言語と依存関係のインストール方法については、「SDK for Java のコード例」をご参照ください。

• Alibaba Cloud CLI

  • Alibaba Cloud CLI を使用すると、ターミナルから aliyun コマンドを実行して Alibaba Cloud サービスを操作し、クラウドサービスリソースを管理できます。詳細については、「Alibaba Cloud CLI とは」をご参照ください。

  • Alibaba Cloud CLI は現在、Domain Names API をサポートしていません。

• Terraform

  • Terraform は、テンプレートを API 呼び出しに変換することでクラウドインフラストラクチャのプレビュー、プロビジョニング、管理を行うオープンソースツールです。詳細については、「Alibaba Cloud Terraform とは」をご参照ください。

  • Terraform は現在、Domain Names API をサポートしていません。

• Resource Orchestration Service (ROS)

  • Resource Orchestration Service (ROS) は、テンプレートを通じてクラウドリソースのプロビジョニングを自動化します。テンプレートで必要なリソースとその依存関係を定義すると、ROS が自動的にそれらを作成および設定します。詳細については、「Resource Orchestration Service とは」をご参照ください。

  • ROS は現在、Domain Names API をサポートしていません。

• カスタム API 呼び出し

  • ネイティブ HTTP 呼び出しを行うには、署名アルゴリズムを実装し、カスタムリクエストを構築し、HTTP 呼び出しを開始する必要があります。署名メカニズムの詳細については、「V3 リクエスト構造と署名」をご参照ください。

注意事項

• Domain Names API 呼び出しでエラーが返された場合は、エラーコードを使用してリクエストパラメーターと値が正しいかどうかを確認してください。

• また、レスポンスまたは SDK エラーメッセージからリクエスト ID を記録し、Alibaba Cloud OpenAPI 診断プラットフォームを使用して自己診断を行うこともできます。