Skip to main content
このページのエンドポイントは、ウェブサイトアプリケーション — ウェブドメインを持つアプリ — にのみ適用されます。ウェブ以外のアプリケーションに対して呼び出すと失敗します。

カスタムドメイン

api.SetApplicationCustomDomain(appID, domain) は、ウェブサイトに紐付けるカスタムドメインを設定します。

DNS レコード

カスタムドメインを紐付けた後は、レジストラ側で DNS を設定する必要があります。api.GetApplicationDNS(appID) は、作成すべきレコードを []squarecloud.DNSRecord として返します。

アナリティクス

api.GetApplicationAnalytics(appID, start, end) は、指定した期間の集約されたエッジアナリティクスを squarecloud.NetworkAnalytics として返します。期間の指定は必須で、最大保持期間は 7 日間 です。
レスポンスには 15 分単位の時系列(VisitsCountriesDevicesOSBrowsersProtocolsMethodsPathsReferersProviders)と、期間全体のバケット(IPsStatusCodesBotsContentTypes)が含まれます。
アプリケーションの作成前に完全に収まる期間を指定した場合、API は空のオブジェクトを返します — レスポンス内のすべてのスライスが nil になります。インデックスアクセスの前に長さを確認してください。

ドリルダウンフィルタ

期間に加えて、このエンドポイントはクエリパラメータとしてオプションのフィルタを受け付けます — rest.WithQueryParam で渡してください。各フィルタは、レスポンス内のすべての内訳を一度に絞り込みます:

エラートラッキング

api.GetApplicationNetworkErrors(appID, start, end) は、エッジのエラー内訳を返します。デフォルトでは 5xx エラーのみが含まれます — 4xx を含めるには include_4xx=true を追加してください。

リクエスト単位のログ

api.GetApplicationNetworkLogs(appID, start, end) は、リクエスト単位のエッジログを返します。
リクエスト単位のログには Pro プラン 以上が必要です。

レイテンシパーセンタイル

api.GetApplicationNetworkPerformance(appID, start, end) は、エッジレイヤーとオリジンレイヤーの p50 / p95 / p99 レイテンシを返します。
パフォーマンスメトリクスには Pro プラン 以上が必要です。

エッジキャッシュのパージ

api.PurgeApplicationCache(appID) は、アプリケーションのドメインに対するエッジキャッシュ全体を無効化します。

アカウント全体のドメインとロードバランサー

この 2 つのメソッドは、単一のウェブサイトではなく、アカウント内のすべてのアプリケーションを対象に動作します。

すべてのドメインの一覧取得

api.GetApplicationDomains() は、アカウントのすべてのアプリケーションにわたって設定されているすべてのドメインを []squarecloud.AppDomain として返します。カスタムドメインが先に列挙され、ウェブドメインを持たないアプリケーションは含まれません。

ロードバランサー

api.GetLoadBalancers() は、カスタムドメインを共有するアプリケーションをグループ化し、squarecloud.LoadBalancers を返します。
2 つ以上のアプリを持つグループはアクティブなロードバランサーです: トラフィックはエッジで分散され、いずれかのアプリがオフラインになった場合は自動フェイルオーバーが働きます。Limit は、アカウントのプランで 1 つのドメインを共有できるアプリケーションの最大数です: 2(Standard)、5(Pro)、10(Enterprise)。