このAPIを呼び出して、Smart Access Gateway (SAG) インスタンスのDNSサーバーを変更できます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
アクション String 任意 ModifySagUserDns

実行する操作です。

値をModifySagUserDnsに設定します。

MasterDns String 必須 192.XX.XX.1

プライマリDNSサーバーのIPアドレス。

注 このパラメーターを設定しない場合、既存のDNSサーバーのIPアドレスはクリアされます。
RegionId String 必須 cn-shanghai

SAGインスタンスがデプロイされているリージョンのID。
SlaveDns String 必須 192.XX.XX.2

セカンダリDNSサーバーのIPアドレス。

注 このパラメーターを設定しない場合、既存のDNSサーバーのIPアドレスはクリアされます。
SmartAGId String 必須 sag-whfn****

SAGインスタンスのID。
SmartAGSn String 必須 sag32a30****

SAGデバイスのシリアル番号 (SN) 。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 1120228A-E5E1-4E9C-B56D-96887E1A2B2F

リクエストの ID です。

例

リクエストの例

http(s):// smartag.cn-shanghai.aliyuncs.com/? アクション=ModifySagUserDns
&MasterDns=192.XX. XX.1
&RegionId=cn-上海
&SlaveDns=192.XX. XX.2
&SmartAGId=sag-whfn ****
&SmartAGSn=sag32a30 ****
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<ModifySagUserDnsResponse>
      <RequestId>1120228A-E5E1-4E9C-B56D-96887E1A2B2F</RequestId>
</ModifySagUserDnsResponse>

JSON 形式 

{
"RequestId": "1120228A-E5E1-4E9C-B56D-96887E1A2B2F"
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明
400 SAG.InstanceNoFound 指定されたSAGインスタンスは存在しません。 指定されたSAGインスタンスが存在しない場合に返されるエラーメッセージ。
400 SAG.SoftwareNotSupport 指定されたSAGソフトウェアエディションインスタンスはACLをサポートしていません。 指定されたSAGインスタンスがACLをサポートしていない場合に返されるエラーメッセージ。
500 SmartAccessGatewayInArrears 指定されたSmart Access Gatewayの有効期限が切れています。 指定されたSAGインスタンスの有効期限が切れた場合に返されるエラーメッセージ。 最初にSAGインスタンスを更新します。
500 SmartAccessGatewayNotActivated 指定されたSmart Access Gatewayは有効化されていません。 指定されたSAGがアクティブ化されていない場合に返されるエラーメッセージ。 最初にSAGインスタンスをアクティブ化します。
403 SmartAccessGatewayNotOnline 指定されたスマートアクセスゲートウェイがオンラインではありません。 指定されたSAGデバイスがAlibaba Cloudに接続されていない場合に返されるエラーメッセージ。
500 SmartAccessGatewayOffline リクエストを完了できません。 Smart Access Gatewayはオフラインです。 指定されたSAGデバイスがAlibaba Cloudから切断された場合に返されるエラーメッセージ。
400 InstanceNotExit 指定されたインスタンスは存在しません。 指定されたインスタンスが存在しない場合に返されるエラーメッセージ。
400 ConfigUnsynchronized ネットワーク設定が同期されていません。 ネットワーク設定がSAGデバイスとインスタンスの間で同期されていない場合に返されるエラーメッセージ。
403 FeatureNotSupport スマートアクセスゲートウェイの現在のエディションは、この機能をサポートしていません。 現在のバージョンのSAGインスタンスがこの機能をサポートしていない場合に返されるエラーメッセージ。
403 FeatureNotSupportForActiveSmartAG アクティブなスマートアクセスゲートウェイの現在のエディションは、この機能をサポートしていません。 アクティブなSAGデバイスの現在のバージョンがこの機能をサポートしていない場合に返されるエラーメッセージ。
403 FeatureNotSupportForStandBySmartAG スタンバイスマートアクセスゲートウェイの現在のエディションは、この機能をサポートしていません。 現在のバージョンのスタンバイSAGデバイスがこの機能をサポートしていない場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。