メニュー

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?

トランク

トランクリソースは、Twilio アカウントの SIP トランクを表します。トランクは、クレデンシャルリストIP アクセスコントロールリストオリジネーション URL、および電話番号を所有します。

SIP トランクの作成および使用方法については、クイックスタートガイドをご覧ください。

アクション

リソースのプロパティ

Names in PHP format
accountSid
sid<AC> Not PII

このトランクを所有するアカウントの一意の ID。

domainName
文字列 Not PII

Twilio で予約されている、SIP トラフィックをルーティングする先の一意のアドレス。ドメイン名には英字、数字、および - を指定でき、必ず pstn.twilio.com で終わらなければなりません。 詳細については、「ターミネーション設定」を参照してください。

disasterRecoveryMethod
http_method Not PII

DisasterRecoveryUrl へリクエストを送信する際に、Twilio が使用する HTTP のメソッドです。GET または POST のいずれかです。

disasterRecoveryUrl
url Not PII

設定されているオリジネーション URL への SIP トラフィックの送信中にエラーが発生した場合、Twilio がリクエストを送信するHTTP URL。Twilio はこの URL から TwiML を取得し、他の通常の TwiML 通話と同じようにその命令を実行します。詳細については、「ディザスターリカバリー」を参照してください。

friendlyName
文字列 Not PII

人間が読みやすい形式のトランクの名前。

secure
boolean Not PII

このトランクのセキュアトランキング設定。オンの場合、このトランクを経由するすべての通話が、メディアには SRTP を使い、シグナリングには TLS を使って保護されます。オフの場合は、メディアに RTP が使われます。Twilio はこの URL から TwiML を取得し、他の通常の TwiML 通話と同じように、その命令を実行します。 詳細については、「セキュアトランキング」を参照してください。

recording
オブジェクト Not PII

このトランクの録音設定。オンの場合、このトランクを経由するすべての通話が録音され、電話が鳴った時点または電話に応答した時点から録音を開始できます。Twilio はこの URL から TwiML を取得し、他の通常の TwiML 通話と同じように、その命令を実行します。 詳細については、「録音」を参照してください。

cnamLookupEnabled
boolean Not PII

The Caller ID Name (CNAM) lookup setting for this trunk. If turned on, all inbound calls to this SIP Trunk from the United States and Canada will automatically perform a CNAM Lookup and display Caller ID data on your phone. See CNAM Lookups for more information.

authType
文字列 Not PII

ドメインにマップされている認証のタイプ。可能な値は IP_ACLCREDENTIAL_LIST です。ドメインに両方がセットアップされている場合は、カンマ区切りで両方が返されます。ドメインに一方をセットアップしていない場合は、いかなるトラフィックも遮断されます。

authTypeSet
string[] Not PII

dateCreated
date_time<iso8601> Not PII

このActivityが作成された日付です。

dateUpdated
date_time<iso8601> Not PII

このActivityが更新された日付です。

sid
sid<TR> Not PII

Twilio で SIP トランクを一意に識別する 34 文字の文字列。

url
url Not PII

以下を基準とする、このリソースの相対的な URL。 https://trunking.twilio.com

links
uri_map Not PII


すべてのトランクをリストする

先頭に戻る

GET /Trunks

アカウントに対するすべての SIP トランクのページ化リストを取得します。

curl -G https://trunking.twilio.com/v1/Trunks \
    -u '{twilio account sid}:{twilio auth token}'

レスポンス例

{
  "trunks": [
    {
      "sid": "TKfa1e5a85f63bfc475c2c753c0f289932",
      "account_sid": "ACxxx",
      "domain_name": "anniebpsip.pstn.twilio.com",
      "disaster_recovery_method": "POST",
      "disaster_recovery_url": "https://uh-oh.mytrunkingappbroke.io/recovery",
      "friendly_name": "anniebp",
      "secure": false,
      "cnam_lookup_enabled": false,
      "recording": {
        "trim": "do-not-trim",
        "mode": "record-from-ringing"
      },
      "auth_type": "CREDENTIAL_LIST",
      "auth_type_set": [
        "CREDENTIAL_LIST"
      ],
      "date_created": "2015-03-10T04:57:44Z",
      "date_updated": "2015-09-02T23:23:11Z",
      "url": "https://trunking.twilio.com/v1/Trunks/TKfa1e5a85f63bfc475c2c753c0f289932",
      "links": {
        "origination_urls": "https://trunking.twilio.com/v1/Trunks/TKfa1e5a85f63bfc475c2c753c0f289932/OriginationUrls",
        "credential_lists": "https://trunking.twilio.com/v1/Trunks/TKfa1e5a85f63bfc475c2c753c0f289932/CredentialLists",
        "ip_access_control_lists": "https://trunking.twilio.com/v1/Trunks/TKfa1e5a85f63bfc475c2c753c0f289932/IpAccessControlLists",
        "phone_numbers": "https://trunking.twilio.com/v1/Trunks/TKfa1e5a85f63bfc475c2c753c0f289932/PhoneNumbers"
      }
    }
  ],
  "meta": {
    "page": 0,
    "page_size": 50,
    "first_page_url": "https://trunking.twilio.com/v1/Trunks?PageSize=50&Page=0",
    "previous_page_url": null,
    "url": "https://trunking.twilio.com/v1/Trunks?PageSize=50&Page=0",
    "next_page_url": null,
    "key": "trunks"
  }
}


SIPトランクを作成する

先頭に戻る

POST /Trunks

新しい SIP トランクを作成します。

curl -XPOST https://trunking.twilio.com/v1/Trunks \
    -d "FriendlyName=MyTrunk" \
    -u '{twilio account sid}:{twilio auth token}'

オプションパラメーター

Names in PHP format
friendlyName
オプション
post 文字列 Not PII

人間が読みやすい形式のトランクの名前。

domainName
オプション
post 文字列 Not PII

Twilio で予約されている、SIP トラフィックをルーティングする先の一意のアドレス。ドメイン名には英字、数字、および - を指定でき、必ず pstn.twilio.com で終わらなければなりません。 詳細については、「ターミネーション設定」を参照してください。

disasterRecoveryUrl
オプション
post url Not PII

設定されているオリジネーション URL への SIP トラフィックの送信中にエラーが発生した場合、Twilio がリクエストを送信するHTTP URL。Twilio はこの URL から TwiML を取得し、他の通常の TwiML 通話と同じようにその命令を実行します。詳細については、「ディザスターリカバリー」を参照してください。

disasterRecoveryMethod
オプション
post http_method Not PII

DisasterRecoveryUrl へリクエストを送信する際に、Twilio が使用する HTTP のメソッドです。GET または POST のいずれかです。

recording
オプション
post ienum:recording_setting Not PII

このトランクの録音設定。オンの場合、このトランクを経由するすべての通話が録音され、電話が鳴った時点または電話に応答した時点から録音を開始できます。詳細については、「録音」を参照してください。

secure
オプション
post boolean Not PII

このトランクのセキュアトランキング設定。オンの場合、このトランクを経由するすべての通話が、メディアには SRTP を使い、シグナリングには TLS を使って保護されます。オフの場合は、メディアに RTP が使われます。詳細については、「セキュアトランキング」を参照してください。

cnamLookupEnabled
オプション
post boolean Not PII

The Caller ID Name (CNAM) lookup setting for this trunk. If turned on, all inbound calls to this SIP Trunk from the United States and Canada will automatically perform a CNAM Lookup and display Caller ID data on your phone. See CNAM Lookups for more information.

レスポンス例

{
  "sid": "TK81a7b93bbf6945bb65b004f39002b9d5",
  "account_sid": "ACxxx",
  "domain_name": null,
  "disaster_recovery_method": null,
  "disaster_recovery_url": null,
  "friendly_name": "MyTrunk",
  "secure": false,
  "cnam_lookup_enabled": false,
  "recording": {
    "trim": "do-not-trim",
    "mode": "do-not-record"
  },
  "auth_type": "",
  "auth_type_set": [],
  "date_created": "2015-09-02T23:29:47Z",
  "date_updated": "2015-09-02T23:29:47Z",
  "url": "https://trunking.twilio.com/v1/Trunks/TK81a7b93bbf6945bb65b004f39002b9d5",
  "links": {
    "origination_urls": "https://trunking.twilio.com/v1/Trunks/TK81a7b93bbf6945bb65b004f39002b9d5/OriginationUrls",
    "credential_lists": "https://trunking.twilio.com/v1/Trunks/TK81a7b93bbf6945bb65b004f39002b9d5/CredentialLists",
    "ip_access_control_lists": "https://trunking.twilio.com/v1/Trunks/TK81a7b93bbf6945bb65b004f39002b9d5/IpAccessControlLists",
    "phone_numbers": "https://trunking.twilio.com/v1/Trunks/TK81a7b93bbf6945bb65b004f39002b9d5/PhoneNumbers"
  }
}


SIP トランクを取得する

先頭に戻る

GET /Trunks/{Trunk SID}

特定の SIP トランクに対するインスタンスデータを取得します。

curl -G https://trunking.twilio.com/v1/Trunks/{trunk sid} \
    -u '{twilio account sid}:{twilio auth token}'

レスポンス例

{
  "sid": "TKe776ce47670e9955b637617acd0ed2d5",
  "account_sid": "ACxxx",
  "domain_name": "obemp-trunk.pstn.twilio.com",
  "disaster_recovery_method": null,
  "disaster_recovery_url": null,
  "friendly_name": "obemp-trunk",
  "secure": false,
  "cnam_lookup_enabled": false,
  "recording": {
    "trim": "do-not-trim",
    "mode": "record-from-ringing"
  },
  "auth_type": "CREDENTIAL_LIST",
  "auth_type_set": [
    "CREDENTIAL_LIST"
  ],
  "date_created": "2015-05-05T20:59:07Z",
  "date_updated": "2015-05-05T22:44:23Z",
  "url": "https://trunking.twilio.com/v1/Trunks/TKe776ce47670e9955b637617acd0ed2d5",
  "links": {
    "origination_urls": "https://trunking.twilio.com/v1/Trunks/TKe776ce47670e9955b637617acd0ed2d5/OriginationUrls",
    "credential_lists": "https://trunking.twilio.com/v1/Trunks/TKe776ce47670e9955b637617acd0ed2d5/CredentialLists",
    "ip_access_control_lists": "https://trunking.twilio.com/v1/Trunks/TKe776ce47670e9955b637617acd0ed2d5/IpAccessControlLists",
    "phone_numbers": "https://trunking.twilio.com/v1/Trunks/TKe776ce47670e9955b637617acd0ed2d5/PhoneNumbers"
  }
}


SIP トランクをアップデートする

先頭に戻る

POST /Trunks/{Trunk SID}

SIP トランクのプロパティーをアップデートします。

curl -XPOST https://trunking.twilio.com/v1/Trunks/{trunk sid} \
    -d "DisasterRecoveryUrl=https://uh-oh.mytrunkingappbroke.io/recovery" \
    -d "DisasterRecoveryMethod=POST" \
    -u '{twilio account sid}:{twilio auth token}'

オプションパラメーター

Names in PHP format
sid
必須
post sid<TR> Not PII

Twilio で SIP トランクを一意に識別する 34 文字の文字列。

friendlyName
オプション
post 文字列 Not PII

人間が読みやすい形式のトランクの名前。

domainName
オプション
post 文字列 Not PII

Twilio で予約されている、SIP トラフィックをルーティングする先の一意のアドレス。ドメイン名には英字、数字、および - を指定でき、必ず pstn.twilio.com で終わらなければなりません。 詳細については、「ターミネーション設定」を参照してください。

disasterRecoveryUrl
オプション
post url Not PII

設定されているオリジネーション URL への SIP トラフィックの送信中にエラーが発生した場合、Twilio がリクエストを送信するHTTP URL。Twilio はこの URL から TwiML を取得し、他の通常の TwiML 通話と同じようにその命令を実行します。詳細については、「ディザスターリカバリー」を参照してください。

disasterRecoveryMethod
オプション
post http_method Not PII

DisasterRecoveryUrl へリクエストを送信する際に、Twilio が使用する HTTP のメソッドです。GET または POST のいずれかです。

recording
オプション
post ienum:recording_setting Not PII

このトランクの録音設定。オンの場合、このトランクを経由するすべての通話が録音され、電話が鳴った時点または電話に応答した時点から録音を開始できます。詳細については、「録音」を参照してください。

secure
オプション
post boolean Not PII

このトランクのセキュアトランキング設定。オンの場合、このトランクを経由するすべての通話が、メディアには SRTP を使い、シグナリングには TLS を使って保護されます。オフの場合は、メディアに RTP が使われます。詳細については、「セキュアトランキング」を参照してください。

cnamLookupEnabled
オプション
post boolean Not PII

The Caller ID Name (CNAM) lookup setting for this trunk. If turned on, all inbound calls to this SIP Trunk from the United States and Canada will automatically perform a CNAM Lookup and display Caller ID data on your phone. See CNAM Lookups for more information.

レスポンス例

{
  "sid": "TKfa1e5a85f63bfc475c2c753c0f289932",
  "account_sid": "ACxxx",
  "domain_name": "anniebpsip.pstn.twilio.com",
  "disaster_recovery_method": "POST",
  "disaster_recovery_url": "https://uh-oh.mytrunkingappbroke.io/recovery",
  "friendly_name": "anniebp",
  "secure": false,
  "cnam_lookup_enabled": false,
  "recording": {
    "trim": "do-not-trim",
    "mode": "record-from-ringing"
  },
  "auth_type": "CREDENTIAL_LIST",
  "auth_type_set": [
    "CREDENTIAL_LIST"
  ],
  "date_created": "2015-03-10T04:57:44Z",
  "date_updated": "2015-09-02T23:32:19Z",
  "url": "https://trunking.twilio.com/v1/Trunks/TKfa1e5a85f63bfc475c2c753c0f289932",
  "links": {
    "origination_urls": "https://trunking.twilio.com/v1/Trunks/TKfa1e5a85f63bfc475c2c753c0f289932/OriginationUrls",
    "credential_lists": "https://trunking.twilio.com/v1/Trunks/TKfa1e5a85f63bfc475c2c753c0f289932/CredentialLists",
    "ip_access_control_lists": "https://trunking.twilio.com/v1/Trunks/TKfa1e5a85f63bfc475c2c753c0f289932/IpAccessControlLists",
    "phone_numbers": "https://trunking.twilio.com/v1/Trunks/TKfa1e5a85f63bfc475c2c753c0f289932/PhoneNumbers"
  }
}


トランクを削除する

先頭に戻る

DELETE /Trunks/{Trunk SID}

アカウントから SIP トランクインスタンスを削除します。

curl -XDELETE https://trunking.twilio.com/v1/Trunks/{trunk sid} \
    -u '{twilio account sid}:{twilio auth token}'

レスポンス例

リクエストが成功すると、HTTP ステータスコード 204 と空の本文が返されます。

Rate this page:

ヘルプが必要ですか?

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.