背景信息

阿里云交易和賬單管理API是一套通用的管理阿里云資源的接口，可以用于查詢服務價格、管理實例、獲取賬單信息等。關于阿里云交易和賬單管理API支持的所有接口，請參見API概覽。

您可以調用阿里云交易和賬單管理API提供的接口，查詢、創建、變更、續費云防火墻實例。關于該接口的調用方式，請參見請求結構。

查詢實例

調用QueryAvailableInstances查詢實例資源。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

響應參數

Data

InstanceList

示例

請求示例

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.google.gson.Gson;
import java.util.*;
import com.aliyuncs.bssopenapi.model.v20171214.*;
/*
pom.xml
<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core</artifactId>
  <version>4.6.0</version>
</dependency>
*/

public class QueryAvailableInstances {

    public static void main(String[] args) {

        DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", "<your-access-key-id>"<YOUR-ACCESS-KEY-ID>secret>");
        /** use STS Token
        DefaultProfile profile = DefaultProfile.getProfile(
            "<your-region-id>",      <YOUR-REGION-ID>on ID.
            "<your-access-key-id>",       // The AccessKey ID of the RAM account.
            "<your-access-key-secret>",<YOUR-ACCESS-KEY-SECRET>et of the RAM account
            "<your-sts-token>");        <YOUR-STS-TOKEN>       **/

        IAcsClient client = new DefaultAcsClient(profile);


        QueryAvailableInstancesRequest request = new QueryAvailableInstancesRequest();
        request.setProductCode("vipcloudfw");

        try {
            QueryAvailableInstancesResponse response = client.getAcsResponse(request);
            System.out.println(new Gson().toJson(response));
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }

    }
}

正常返回示例

{
  "RequestId": "FDE58AA9-37C8-5001-948B-82DE61353864",
  "Message": "Successful!",
  "Data": {
    "TotalCount": 1,
    "PageNum": 1,
    "PageSize": 20,
    "InstanceList": [
      {
        "Status": "Normal",
        "SubscriptionType": "Subscription",
        "OwnerId": 19xxxxxxxxx6359163,
        "EndTime": "2023-06-21T16:00:00Z",
        "ProductCode": "vipcloudfw",
        "InstanceID": "vipcloudfw-cn-pe333nx****",
        "CreateTime": "2021-12-21T05:17:32Z",
        "ProductType": "vipcloudfw",
        "RenewalDurationUnit": "M",
        "Seller": "2****",
        "SubStatus": "Normal",
        "RenewStatus": "ManualRenewal"
      }
    ]
  },
  "Code": "Success",
  "Success": true
}

創建實例

調用CreateInstance創建一個實例資源，調用接口會自動創建一個新購實例資源的訂單，并自動支付。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

Parameter

返回參數

示例

下面代碼創建了預付費中國站云防火墻，使用手動續費，且預付費用1個月。

請求示例

import com.aliyuncs.CommonRequest;
import com.aliyuncs.CommonResponse;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.profile.DefaultProfile;
/*
pom.xml
<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core</artifactId>
  <version>4.6.0</version>
</dependency>
*/

public class CreateInstance {
    public static void main(String[] args) {

        DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", "<your-access-key-id><YOUR-ACCESS-KEY-ID>-secret>");
        /** use STS Token
        DefaultProfile profile = DefaultProfile.getProfile(
            "<your-region-id>",     <YOUR-REGION-ID>ion ID.
            "<your-access-key-id>",       // The AccessKey ID of the RAM account.
            "<your-access-key-secret>"<YOUR-ACCESS-KEY-SECRET>ret of the RAM account.
            "<your-sts-token>");       <YOUR-STS-TOKEN>
        **/

        IAcsClient client = new DefaultAcsClient(profile);

        CommonRequest request = new CommonRequest();

        request.setSysMethod(MethodType.POST);
        request.setSysDomain("business.aliyuncs.com");
        request.setSysVersion("2017-12-14");
        request.setSysAction("CreateInstance");
        request.putQueryParameter("RenewalStatus", "ManualRenewal");
        request.putQueryParameter("ProductCode", "vipcloudfw");
        request.putQueryParameter("Parameter.1.Code", "CfwAccount");
        request.putQueryParameter("Parameter.1.Value", "true");
        request.putQueryParameter("Parameter.2.Code", "CfwAccount");
        request.putQueryParameter("Parameter.2.Value", "true");
        request.putQueryParameter("Parameter.3.Code", "VpcBandwidth");
        request.putQueryParameter("Parameter.3.Value", "1000");//VPC流量處理能力為1000 Mbps。
        request.putQueryParameter("Parameter.4.Code", "AclExtension");
        request.putQueryParameter("Parameter.4.Value", "1000");//訪問控制全局擴展為1000條。
        request.putQueryParameter("Parameter.5.Code", "CfwAccountNum");
        request.putQueryParameter("Parameter.5.Value", "1");//多賬號管控數為1。
        request.putQueryParameter("Parameter.6.Code", "FwVpcNumber");
        request.putQueryParameter("Parameter.6.Value", "10");//可防護的VPC數為10個。
        request.putQueryParameter("Parameter.7.Code", "IpNumber");
        request.putQueryParameter("Parameter.7.Value", "400");//可防護公網IP數為400。
        request.putQueryParameter("Parameter.8.Code", "CfwLogStorage");
        request.putQueryParameter("Parameter.8.Value", "10000");//日志存儲容量為10000 GB。
        request.putQueryParameter("Parameter.9.Code", "CfwLog");
        request.putQueryParameter("Parameter.9.Value", "true");//開通日志分析功能。
        request.putQueryParameter("Parameter.10.Code", "BandWidth");
        request.putQueryParameter("Parameter.10.Value", "200");//公網流量處理能力為200 Mbps。
        request.putQueryParameter("Parameter.11.Code", "Spec");
        request.putQueryParameter("Parameter.11.Value", "4");//旗艦版。
        request.putQueryParameter("SubscriptionType", "Subscription");//預付費類型。
        request.putQueryParameter("Period", "1");//1個月。
        try {
            CommonResponse response = client.getCommonResponse(request);
            System.out.println(response.getData());
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            e.printStackTrace();
        }
    }
}

正常返回示例

云防火墻創建成功會返回實例ID（InstanceId），實例ID在后續變配和續費中將用到。

{
  "RequestId": "13B1DCF7-0B7C-5426-BC08-869887FCCCEC",
  "Message": "Successful!",
  "Data": {
    "InstanceId": "vipcloudfw-cn-pe333nx****",
    "OrderId": 22165938636****
  },
  "Code": "Success",
  "Success": true
}

變更實例

調用ModifyInstance對實例資源配置進行變更。調用接口會創建一個變配實例資源的訂單，并自動支付。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

Parameter

響應參數

示例

下面代碼為您實現將公網流量處理能力從200 Mbps升級到500 Mbps。

請求示例

import com.aliyuncs.CommonRequest;
import com.aliyuncs.CommonResponse;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.profile.DefaultProfile;
/*
pom.xml
<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core</artifactId>
  <version>4.6.0</version>
</dependency>
*/

public class ModifyInstance {
    public static void main(String[] args) {

        DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", "<your-access-key-id><YOUR-ACCESS-KEY-ID>-sec<YOUR-ACCESS-KEY-SECRET>TS Token
        DefaultProfile profile = DefaultProfile.getProfile(
            "<your-region-id>",    <YOUR-REGION-ID>>ion ID
            "<your-access-key-id>",       // The AccessKey ID of the RAM account
            "<your-access-key-secret><YOUR-ACCESS-KEY-SECRET>cret of the RAM account
            "<your-sts-token>");      <YOUR-STS-TOKEN>>       **/

        IAcsClient client = new DefaultAcsClient(profile);

        CommonRequest request = new CommonRequest();

        request.setSysMethod(MethodType.POST);
        request.setSysDomain("business.aliyuncs.com");
        request.setSysVersion("2017-12-14");
        request.setSysAction("ModifyInstance");
        request.putQueryParameter("ProductCode", "vipcloudfw");
        request.putQueryParameter("SubscriptionType", "Subscription");
        request.putQueryParameter("ModifyType", "Upgrade");
        request.putQueryParameter("InstanceId", "vipcloudfw-cn-pe333nx****");
        request.putQueryParameter("Parameter.1.Code", "BandWidth");
        request.putQueryParameter("Parameter.1.Value", "500");
        try {
            CommonResponse response = client.getCommonResponse(request);
            System.out.println(response.getData());
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            e.printStackTrace();
        }
    }
}

正常返回示例

{
  "Message": "Successful!",
  "RequestId": "3EC4C157-46E3-5341-82B0-8CEEC7637F93",
  "Data": {
    "OrderId": 22165938810****,
    "HostId": "cn****"
  },
  "Code": "Success",
  "Success": true
}

實例續費

調用RenewInstance對相關實例進行續費。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

響應參數

示例

以下是實現續費6個月的代碼示例。

請求示例

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.google.gson.Gson;
import java.util.*;
import com.aliyuncs.bssopenapi.model.v20171214.*;
/*
pom.xml
<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core</artifactId>
  <version>4.6.0</version>
</dependency>
*/

public class RenewInstance {

    public static void main(String[] args) {

        DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", "<your-access-key-id>"<YOUR-ACCESS-KEY-ID>secret>");
        /** use STS Token
        DefaultProfile profile = DefaultProfile.getProfile(
            "<your-region-id>",      <YOUR-REGION-ID>on ID.
            "<your-access-key-id>",       // The AccessKey ID of the RAM account.
            "<your-access-key-secret>",<YOUR-ACCESS-KEY-SECRET>et of the RAM account.
            "<your-sts-token>");        <YOUR-STS-TOKEN>       **/

        IAcsClient client = new DefaultAcsClient(profile);


        RenewInstanceRequest request = new RenewInstanceRequest();
        request.setProductCode("vipcloudfw");
        request.setInstanceId("vipcloudfw-cn-pe333nx****");
        request.setRenewPeriod(6);

        try {
            RenewInstanceResponse response = client.getAcsResponse(request);
            System.out.println(new Gson().toJson(response));
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }

    }
}

正常返回示例

{
  "Message": "Successful!",
  "RequestId": "E15FB71F-7FF8-5272-80B1-B4E73BE4CB99",
  "Data": {
    "OrderId": 22167752456****
  },
  "Code": "Success",
  "Success": true
}