メニュー

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Monitor REST API: Alerts

Alertインスタンスリソースは、TwilioがWebhookリクエストをサーバーに発行したり、アプリケーションが(Twilioの)REST APIに対してリクエストを発行する際のエラーや警告の1件分のログ項目を表しています。 これらはデバッグの過程で特に有用で、モニター・アラート・トリガー を使って、新しいアラートをメールかWebhookで通知するよう構成できます。

Alert properties

特記事項 : 他のREST APIと違い、アラートインスタンスのレスポンスは リストリソース です。アラートに含まれる非常に大量のデータの可能性のため、HTTPリクエストとレスポンスデータはアラートインスタンスリソースの中だけで返されます。

Names in PHP format
accountSid
sid<AC> Not PII

このアラートに関連するアカウントの一意なID。

alertText
文字列 Not PII

アラートのテキスト

apiVersion
文字列 Not PII

The version of the Twilio API in use when this alert was generated. May be empty for events that don't have a specific API version.

dateCreated
date_time<iso8601> Not PII

リソースが生成された日時ISO 8601 フォーマットで提供

dateGenerated
date_time<iso8601> Not PII

アラートが実際に生成された日時。ISO 8601で提供バッファリングのため、少し DateCreated とは異なります。

dateUpdated
date_time<iso8601> Not PII

最も最近にアップデートされた日時ISO 8601 フォーマットで提供

errorCode
文字列 Not PII

エラーの状態を示すユニークなエラー コードです。 Twilio の エラー コード リファレンスで、エラーとその原因や解決策を調べることができます。

logLevel
文字列 Not PII

ログレベルの状態を表します。'error', 'warning', 'notice', 'debug' のいずれかです。

moreInfo
文字列 Not PII

このエラーに関する詳しい情報を得られる URL です。 URL は Twilio の エラー コード リファレンスのページです。

requestMethod
http_method Not PII

If the Alert was generated by a request Twilio made to your server, this will be the request method used when Twilio made the request to your server. If the Alert was generated by a request from your application to Twilio's API, this will be the request method your application used in the request to the API.

requestUrl
uri Not PII

If the Alert was generated by a request Twilio made to your server, this will be the URL on your server that generated the alert. If the Alert was generated by a request from your application to Twilio's API, this will be the URL of the resource in Twilio's API.

resourceSid
sid Not PII

The unique ID of the resource for which the Alert was generated. For instance, if your server failed to respond to an HTTP request during the flow of a particular call, this will be the ID for the call that failed. Empty if the Alert was generated without respect to a particular resource.

sid
sid<NO> Not PII

このアラートを識別する 34 文字の文字列です。

url
url Not PII

このリソースの絶対 URL です。

Fetch an Alert resource

GET
https://monitor.twilio.com/v1/Alerts/{Sid}
        
        
        
        

        Read multiple Alert resources

        GET
        https://monitor.twilio.com/v1/Alerts

        アカウントに対して生成されたアラートのリストを返します。このリストはページ情報を含みます。

        パラメーター
        Names in PHP format
        logLevel
        オプション
        GET 文字列 Not PII

        このログレベルに対するアラートのみを表示します。 「error」、「warning」、「notice」、または「debug」のいずれかを指定します。

        startDate
        オプション
        GET date<iso8601> Not PII

        この日付以降のアラートのみを返します。EndDate と組み合わせて、アラートの日付範囲を定義するのに役立ちます。入力はUTC ISO 8601タイムスタンプですが、時間の部分はフィルターで無視されます。 過去30日間以前のアラートの照会には対応していません。

        endDate
        オプション
        GET date<iso8601> Not PII

        この日付以前のアラートのみを返します。StartDate と組み合わせて、アラートの日付範囲を定義するのに役立ちます。入力はUTC ISO 8601タイムスタンプですが、時間の部分はフィルターで無視されます。過去30日間以前のアラートの照会には対応していません。

        例 1
              
              
              
              
              例 2
                    
                    
                    
                    
                    Only show WARNING alerts generated between midnight April 1, 2015 and midnight April 30, 2015

                    Date range example

                    Only show WARNING alerts generated between midnight April 1, 2015 and midnight April 30, 2015

                    Delete an Alert resource

                    削除する
                    https://monitor.twilio.com/v1/Alerts/{Sid}

                    {AlertSid} で識別されるアラートを、アカウントのログから削除します。削除に成功すると、ボディーなしで HTTP ステータス 204 (No Content) を返します。

                          
                          
                          
                          

                          ヘルプが必要ですか?

                          We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.