Buat, Kueri & Hapus Resource VPC dengan Java SDK - Cloud Control API

Topik ini menjelaskan cara menggunakan SDK untuk memanggil Cloud Control API guna mengelola sumber daya. Dalam topik ini, vSwitch dalam Virtual Private Cloud (VPC) digunakan sebagai contoh dengan kode sampel yang ditulis dalam Java. Tutorial ini membimbing Anda melalui prosedur untuk mengimpor SDK, menanyakan metadata sumber daya, membuat, menanyakan, memperbarui, dan menghapus sumber daya, serta menanyakan status tugas ketika operasi asinkron diaktifkan untuk Operasi API Cloud Control.

Prasyarat

Pengguna RAM:
- Buat pasangan AccessKey untuk pengguna RAM. Akun Alibaba Cloud memiliki semua izin pada sumber daya. Jika pasangan AccessKey akun Alibaba Cloud Anda bocor, sumber daya Anda akan terpapar pada risiko besar. Kami sarankan Anda menggunakan pasangan AccessKey dari pengguna RAM. Untuk informasi lebih lanjut, lihat Buat pasangan AccessKey.
- Berikan izin yang diperlukan pada sumber daya VPC kepada pengguna RAM yang ingin Anda gunakan. Instruksi operasi ini melibatkan berbagai macam operasi pada vSwitch dalam VPC. Anda harus memilih AliyunVPCFullAccess sebagai kebijakan sistem. Anda dapat membuat kebijakan kustom berdasarkan kebutuhan bisnis Anda. Untuk informasi lebih lanjut, lihat Buat kebijakan kustom.
- Pasangan AccessKey pengguna RAM dikonfigurasi dalam variabel lingkungan. Untuk informasi lebih lanjut, lihat Konfigurasikan variabel lingkungan di Linux, macOS, dan Windows.
VPC
Anda harus membuat VPC tempat vSwitch tersebut terkait. Untuk informasi lebih lanjut, lihat Buat dan kelola VPC.
Metadata sumber daya
Manajemen sumber daya diimplementasikan berdasarkan metadata sumber daya. Anda harus familiar dengan Metadata sumber daya.
Operasi sinkron dan asinkron
Pembuatan dan penghapusan sumber daya tidak dilakukan secara sinkron dengan operasi Cloud Control API. Untuk informasi lebih lanjut, lihat operasi sinkron dan asinkron. Jika Anda ingin menanyakan status tugas ketika operasi asinkron diaktifkan untuk Cloud Control API, lihat Tanyakan status tugas.
Java
Anda harus menggunakan Java 8 atau yang lebih baru.

Inisialisasi proyek

Instal CloudControlAPI SDK untuk mendapatkan AccessKey dalam variabel lingkungan.

Impor SDK ke proyek Anda. Untuk informasi lebih lanjut, lihat Instal CloudControlAPI SDK. Anda dapat menggunakan SDK untuk mengintegrasikan dan menggunakan Cloud Control API. Dalam contoh ini, SDK diimpor sebagai berikut:
```
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>cloudcontrol20220830</artifactId>
    <version>1.1.1</version>
</dependency>
```

Buat ExampleDemo untuk mengimplementasikan manajemen sumber daya. Tambahkan metode createClient ke ExampleDemo untuk mendapatkan pasangan AccessKey dalam variabel lingkungan dan menginisialisasi klien. Kode sampel:

/**
 * Inisialisasi klien.
 * @return Client
 */
public static Client createClient() throws Exception {
    // Jika kode proyek bocor, pasangan AccessKey mungkin bocor dan keamanan semua sumber daya dalam akun Anda mungkin terganggu. Contoh kode sampel berikut hanya disediakan untuk referensi. 
    Config config = new Config()
            // Wajib. Pastikan bahwa variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dikonfigurasi. 
            .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
            // Wajib. Pastikan bahwa variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET dikonfigurasi. 
            .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
    # Untuk informasi lebih lanjut tentang titik akhir, lihat https://api.aliyun.com/product/cloudcontrol.
    config.endpoint = "cloudcontrol.aliyuncs.com";
    return new Client(config);
}

Tanyakan detail tipe sumber daya

Anda dapat menanyakan detail tipe sumber daya berdasarkan kode produk dan kode tipe sumber daya. Data yang dikembalikan adalah metadata sumber daya. Operasi manajemen sumber daya selanjutnya seperti pembuatan, penanyaaan, daftar, dan penghapusan diimplementasikan berdasarkan metadata sumber daya.

Anda dapat memanggil operasi GetResourceType untuk mendapatkan detail tipe sumber daya. Dalam contoh ini, vSwitch dalam VPC digunakan. Kode produk VPC adalah VPC, dan kode tipe sumber daya vSwitch adalah vSwitch. Kode sampel:

Catatan

Untuk informasi lebih lanjut tentang cara mendapatkan kode produk dan kode sumber daya, lihat Di mana saya bisa menemukan kode layanan dan kode tipe sumber daya?

/**
 * Tanyakan detail tipe sumber daya.
 * @param productCode      Kode produk, yang merupakan "VPC" dalam contoh ini.
 * @param resourceTypeCode Kode tipe sumber daya, yang merupakan "vSwitch" dalam contoh ini.
 * @param client           Klien
 * @return resourceTypeWithOptions Respons
 */
public GetResourceTypeResponse getResourceType(String productCode, String resourceTypeCode, Client client) throws Exception {
    String requestPath = "/api/v1/providers/Aliyun/products/" + productCode + "/resourceTypes/" + resourceTypeCode;
    com.aliyun.cloudcontrol20220830.models.GetResourceTypeHeaders getResourceTypeHeaders = new com.aliyun.cloudcontrol20220830.models.GetResourceTypeHeaders()
            .setXAcsAcceptLanguage("zh_CH");
    com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
    // Tulis kode Anda sendiri untuk menampilkan respons dari operasi API jika perlu.
    GetResourceTypeResponse resourceTypeWithOptions = client.getResourceTypeWithOptions(requestPath, getResourceTypeHeaders, runtime);
    return resourceTypeWithOptions;
}

Metadata sumber daya yang badan responsnya adalah vSwitch dikembalikan. Untuk informasi lebih lanjut tentang cara menafsirkan metadata sumber daya, lihat GetResourceType - Tanyakan tipe sumber daya. Dalam operasi ini, badan respons adalah:

resourceTypeWithOptions.getBody()

{
  "requestId": "DF147125-4F39-57EF-8E9C-554FE0E3AB77",
  "resourceType": {
    "product": "VPC",
    "listResponseProperties": [
      "/properties/VSwitchName",
      "/properties/ResourceGroupId",
      "/properties/CidrBlock",
      "/properties/Tags/items",
      "/properties/Description",
      "/properties/VSwitchId",
      "/properties/Status",
      "/properties/Tags/items/properties/TagValue",
      "/properties/Ipv6CidrBlock",
      "/properties/CreateTime",
      "/properties/RouteTableId",
      "/properties/VpcId",
      "/properties/Tags/items/properties/TagKey",
      "/properties/ZoneId",
      "/properties/Tags",
      "/properties/IsDefault",
      "/properties/AvailableIpAddressCount"
    ],
    "updateOnlyProperties": [
      
    ],
    "readOnlyProperties": [
      "/properties/Status",
      "/properties/CreateTime",
      "/properties/AvailableIpAddressCount"
    ],
    "createOnlyProperties": [
      "/properties/VpcIpv6CidrBlock"
    ],
    "listOnlyProperties": [
      
    ],
    "primaryIdentifier": "/properties/VSwitchId",
    "getOnlyProperties": [
      
    ],
    "required": [
      "CidrBlock",
      "VpcId",
      "ZoneId"
    ],
    "publicProperties": [
      "/properties/RouteTableId",
      "/properties/CidrBlock",
      "/properties/Description",
      "/properties/VSwitchId",
      "/properties/AvailableIpAddressCount",
      "/properties/CreateTime",
      "/properties/VSwitchName",
      "/properties/ResourceGroupId",
      "/properties/VpcId",
      "/properties/ZoneId",
      "/properties/Status",
      "/properties/RegionId",
      "/properties/IsDefault",
      "/properties/Ipv6CidrBlock",
      "/properties/Tags",
      "/properties/Tags/items",
      "/properties/Tags/items/properties/TagValue",
      "/properties/Tags/items/properties/TagKey"
    ],
    "filterProperties": [
      "/properties/VSwitchName",
      "/properties/ResourceGroupId",
      "/properties/RouteTableId",
      "/properties/VpcId",
      "/properties/VSwitchId",
      "/properties/ZoneId",
      "/properties/IsDefault"
    ],
    "getResponseProperties": [
      "/properties/ResourceGroupId",
      "/properties/CidrBlock",
      "/properties/VSwitchName",
      "/properties/Tags/items",
      "/properties/Description",
      "/properties/VSwitchId",
      "/properties/Status",
      "/properties/Tags/items/properties/TagValue",
      "/properties/Ipv6CidrBlock",
      "/properties/CreateTime",
      "/properties/RouteTableId",
      "/properties/VpcId",
      "/properties/Tags/items/properties/TagKey",
      "/properties/ZoneId",
      "/properties/Tags",
      "/properties/IsDefault",
      "/properties/AvailableIpAddressCount"
    ],
    "handlers": {
      "get": {
        "permissions": [
          "vpc:DescribeVSwitchAttributes",
          "vpc:ListTagResources"
        ]
      },
      "create": {
        "permissions": [
          "vpc:CreateVSwitch"
        ]
      },
      "update": {
        "permissions": [
          "vpc:TagResources",
          "vpc:UnTagResources",
          "vpc:ModifyVSwitchAttribute"
        ]
      },
      "list": {
        "permissions": [
          "vpc:DescribeVSwitches"
        ]
      },
      "delete": {
        "permissions": [
          "vpc:DeleteVSwitch"
        ]
      }
    },
    "deleteOnlyProperties": [
      
    ],
    "updateTypeProperties": [
      "/properties/Description",
      "/properties/VSwitchName",
      "/properties/Ipv6CidrBlock",
      "/properties/Tags",
      "/properties/Tags/items",
      "/properties/Tags/items/properties/TagValue",
      "/properties/Tags/items/properties/TagKey"
    ],
    "properties": {
      "Status": {
        "isRequired": false,
        "extMonitorInfo": false,
        "default": "",
        "deprecated": false,
        "pattern": "",
        "description": "Bidang atribut sumber daya yang mewakili status sumber daya",
        "readOnly": true,
        "sensitive": false,
        "title": "Status sumber daya",
        "type": "string",
        "updateType": false
      },
      "IsDefault": {
        "isRequired": false,
        "extMonitorInfo": false,
        "default": "",
        "deprecated": false,
        "description": "Menunjukkan apakah vSwitch adalah vSwitch default di zona",
        "readOnly": true,
        "sensitive": false,
        "title": "Menunjukkan apakah vSwitch adalah vSwitch default di zona",
        "type": "boolean",
        "updateType": false
      },
      "RouteTableId": {
        "isRequired": false,
        "extMonitorInfo": false,
        "default": "",
        "deprecated": false,
        "pattern": "",
        "description": "ID tabel rute yang terkait dengan vSwitch",
        "readOnly": true,
        "sensitive": false,
        "title": "ID tabel rute yang terkait dengan vSwitch",
        "type": "string",
        "updateType": false
      },
      "Description": {
        "isRequired": false,
        "extMonitorInfo": false,
        "description": "Deskripsi vSwitch",
        "readOnly": false,
        "sensitive": false,
        "title": "Deskripsi vSwitch",
        "type": "string",
        "updateType": true
      },
      "ResourceGroupId": {
        "isRequired": false,
        "extMonitorInfo": false,
        "default": "",
        "deprecated": false,
        "pattern": "",
        "description": "ID grup sumber daya tempat vSwitch termasuk",
        "readOnly": true,
        "sensitive": false,
        "title": "ID grup sumber daya tempat vSwitch termasuk",
        "type": "string",
        "updateType": false
      },
      "ZoneId": {
        "isRequired": true,
        "extMonitorInfo": false,
        "description": "Bidang atribut sumber daya yang mewakili zona",
        "readOnly": false,
        "sensitive": false,
        "title": "ID zona",
        "type": "string",
        "updateType": false
      },
      "VSwitchId": {
        "isRequired": false,
        "extMonitorInfo": false,
        "description": "ID vSwitch",
        "readOnly": false,
        "sensitive": false,
        "title": "ID vSwitch",
        "type": "string",
        "updateType": false
      },
      "AvailableIpAddressCount": {
        "isRequired": false,
        "extMonitorInfo": false,
        "default": "",
        "deprecated": false,
        "format": "int64",
        "pattern": "",
        "description": "Jumlah alamat IP yang tersedia di vSwitch",
        "readOnly": true,
        "sensitive": false,
        "title": "Jumlah alamat IP yang tersedia di vSwitch",
        "type": "integer",
        "updateType": false
      },
      "CreateTime": {
        "isRequired": false,
        "extMonitorInfo": false,
        "default": "",
        "deprecated": false,
        "pattern": "",
        "description": "Waktu pembuatan vSwitch",
        "readOnly": true,
        "sensitive": false,
        "title": "Waktu pembuatan vSwitch",
        "type": "string",
        "updateType": false
      },
      "CidrBlock": {
        "isRequired": true,
        "extMonitorInfo": false,
        "description": "Blok CIDR vSwitch",
        "readOnly": false,
        "sensitive": false,
        "title": "Blok CIDR vSwitch",
        "type": "string",
        "updateType": false
      },
      "VpcId": {
        "isRequired": true,
        "extMonitorInfo": false,
        "description": "ID VPC",
        "readOnly": false,
        "sensitive": false,
        "title": "ID VPC",
        "type": "string",
        "updateType": false
      },
      "VSwitchName": {
        "isRequired": false,
        "extMonitorInfo": false,
        "description": "Nama vSwitch",
        "readOnly": false,
        "sensitive": false,
        "title": "Nama vSwitch",
        "type": "string",
        "updateType": true
      },
      "VpcIpv6CidrBlock": {
        "isRequired": false,
        "extMonitorInfo": false,
        "default": "",
        "deprecated": false,
        "pattern": "",
        "description": "Blok CIDR IPv6 VPC",
        "operatePrivateType": [
          "create"
        ],
        "readOnly": false,
        "sensitive": false,
        "title": "Blok CIDR IPv6 VPC",
        "type": "string",
        "updateType": false
      },
      "RegionId": {
        "isRequired": false,
        "extMonitorInfo": false,
        "description": "Bidang atribut sumber daya yang mewakili wilayah",
        "readOnly": false,
        "sensitive": false,
        "title": "ID wilayah",
        "type": "string",
        "updateType": false
      },
      "Ipv6CidrBlock": {
        "isRequired": false,
        "extMonitorInfo": false,
        "description": "Blok CIDR IPv6 vSwitch",
        "readOnly": false,
        "sensitive": false,
        "title": "Blok CIDR IPv6 vSwitch",
        "type": "string",
        "updateType": true
      },
      "Tags": {
        "isRequired": false,
        "extMonitorInfo": false,
        "description": "Struktur data yang dikembalikan",
        "readOnly": false,
        "sensitive": false,
        "title": "Tag",
        "type": "array",
        "items": {
          "extMonitorInfo": false,
          "deprecated": false,
          "description": "Struktur data yang dikembalikan",
          "sensitive": false,
          "title": "Struktur data yang dikembalikan",
          "type": "object",
          "properties": {
            "TagKey": {
              "isRequired": false,
              "extMonitorInfo": false,
              "description": "Kunci tag",
              "readOnly": false,
              "sensitive": false,
              "title": "Kunci tag",
              "type": "string",
              "updateType": true
            },
            "TagValue": {
              "isRequired": false,
              "extMonitorInfo": false,
              "description": "Nilai tag",
              "readOnly": false,
              "sensitive": false,
              "title": "Nilai tag",
              "type": "string",
              "updateType": true
            }
          },
          "updateType": true
        },
        "updateType": true
      }
    },
    "sensitiveInfoProperties": [
      
    ],
    "info": {
      "deliveryScope": "zone",
      "chargeType": "free",
      "description": "vSwitch",
      "title": "vSwitch"
    },
    "resourceType": "VSwitch"
  }
}

Buat sumber daya

Buat vSwitch untuk operasi selanjutnya seperti pembaruan, penanyaaan, dan penghapusan.

Anda dapat memanggil operasi CreateResource dan memasukkan parameter permintaan berdasarkan metadata sumber daya. Kode sampel:

/**
 * Buat sumber daya
 * @param regionId         ID wilayah.
 * @param productCode      Kode produk, yang merupakan "VPC" dalam contoh ini.
 * @param resourceTypeCode Kode tipe sumber daya, yang merupakan "vSwitch" dalam contoh ini.
 * @param client           Pengguna RAM (klien)
 * @return resourceWithOptions Respons.
 */
public CreateResourceResponse createResource(String regionId, String productCode, String resourceTypeCode, Client client) throws Exception {
    String requestPath = "/api/v1/providers/Aliyun/products/" + productCode + "/resources/" + resourceTypeCode;
    // Parameter respons
    Map body = new HashMap();
    body.put("VpcId", "vpc-m5esjf3a6b380olet****"); // ID VPC.
    body.put("CidrBlock", "172.16.24.0/24"); // Blok CIDR vSwitch. 
    body.put("ZoneId", "cn-qingdao-b");  // ID zona. 
    CreateResourceRequest createResourceRequest = new CreateResourceRequest()
            .setRegionId(regionId)
            .setBody(body);
    com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
    Map<String, String> headers = new HashMap<>();
    CreateResourceResponse resourceWithOptions = client.createResourceWithOptions(requestPath, createResourceRequest, headers, runtime);
    return resourceWithOptions;
}

Jika panggilan berhasil, statusCode=202 dikembalikan, yang menunjukkan bahwa tugas tersebut adalah operasi asinkron. Anda perlu menanyakan status tugas lebih lanjut. Untuk informasi lebih lanjut, lihat Tanyakan tugas. Untuk menanyakan, memperbarui, dan menghapus sumber daya, Anda harus mencatat resourceid. Badan respons adalah sebagai berikut:
resourceWithOptions.getBody()
```
{
  "resourceId": "vsw-m5eaburrn73mdpemo****",
  "requestId": "4F7069A4-3CA8-5A48-9D3D-40A1302CBD1B",
  "resourcePath": "VSwitch/vsw-m5eaburrn73mdpemo****",
  "taskId": "task-5057a4fbef2bcffe44d6b3590****"
}
```

Daftar sumber daya

Anda dapat memanggil operasi GetResources untuk mencantumkan semua sumber daya vSwitch. Kode sampel:

/**
 * Daftar sumber daya
 * @param regionId         ID wilayah
 * @param productCode      Kode produk, yang merupakan "VPC" dalam contoh ini.
 * @param resourceTypeCode Kode tipe sumber daya, yang merupakan "vSwitch" dalam contoh ini.
 * @param client           Pengguna RAM (klien)
 * @return resourceWithOptions Respons.
 */
public GetResourcesResponse getResources(String regionId, String productCode, String resourceTypeCode, Client client) throws Exception {
    String requestPath = "/api/v1/providers/aliyun/products/" + productCode + "/resources/" + resourceTypeCode;
    GetResourcesRequest getResourcesRequest = new GetResourcesRequest()
            .setRegionId(regionId);
    com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
    Map<String, String> headers = new HashMap<>();
    GetResourcesResponse resourcesWithOptions = client.getResourcesWithOptions(requestPath, getResourcesRequest, headers, runtime);
    return resourcesWithOptions;
}

Jika panggilan berhasil, badan respons berikut dikembalikan:

resourcesWithOptions.getBody()

{
  "maxResults": 10,
  "nextToken": "2",
  "requestId": "1B5258F0-656F-5005-9FA7-33845FD9FE33",
  "resources": [
   ...,
    {
      "resourceId": "vsw-m5eaburrn73mdpemo****",
      "resourceAttributes": {
        "IsDefault": false,
        "Status": "Available",
        "Description": "",
        "RouteTableId": "vtb-m5epr0god70hpomnn****",
        "ResourceGroupId": "rg-acfmykd63gtpfpa",
        "ZoneId": "cn-qingdao-b",
        "AvailableIpAddressCount": 252,
        "CreateTime": "2024-10-16T05:30:31Z",
        "VSwitchId": "vsw-m5eaburrn73mdpemo****",
        "CidrBlock": "172.16.24.0/24",
        "VpcId": "vpc-m5esjf3a6b380olet****",
        "VSwitchName": "",
        "RegionId": "cn-qingdao",
        "Ipv6CidrBlock": "",
        "Tags": [
          {
            "TagKey": "acs:tag:createdby",
            "TagValue": "sub:206453422934844953:user****"
          }
        ]
      }
    }
  ],
  "totalCount": 29
}

Perbarui sumber daya

Anda dapat memanggil operasi UpdateResource untuk memperbarui sumber daya tertentu. Kode sampel:

Penting

Berhati-hatilah saat Anda memperbarui sumber daya untuk mencegah operasi tidak sengaja memengaruhi sumber daya lain.

/**
 * Perbarui sumber daya
 * @param regionId         ID wilayah
 * @param productCode      Kode produk, yang merupakan "VPC" dalam contoh ini.
 * @param productCode      Kode produk, yang merupakan "vSwitch" dalam contoh ini.
 * @param resourceId ID sumber daya. Parameter ini menentukan ID vSwitch yang dibuat dalam contoh ini.
 * @param client           Pengguna RAM (klien)
 * @return resourceWithOptions Respons.
 */
public UpdateResourceResponse updateResource(String regionId, String productCode, String resourceTypeCode, String resourceId, Client client) throws Exception {
    String requestPath = "/api/v1/providers/Aliyun/products/" + productCode + "/resources/" + resourceTypeCode + "/" + resourceId;
    // Parameter respons.
    Map body = new HashMap();
    body.put("Description", "Tes pembaruan");
    UpdateResourceRequest updateResourceRequest = new UpdateResourceRequest()
            .setRegionId(regionId)
            .setBody(body);
    com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
    Map<String, String> headers = new HashMap<>();
    UpdateResourceResponse updateResourceResponse = client.updateResourceWithOptions(requestPath, updateResourceRequest, headers, runtime);
    return updateResourceResponse;
}

Kode respons statusCode=200 menunjukkan bahwa permintaan berhasil. Badan respons berikut dikembalikan: Anda dapat menanyakan detail sumber daya untuk memverifikasi apakah sumber daya telah diperbarui. Untuk informasi lebih lanjut, lihat Tanyakan sumber daya.
updateResourceResponse.getBody()
```
{
  "requestId": "C97193DF-FA5A-5B9B-B822-4C128CAC371E"
}
```

Tanyakan sumber daya

Anda dapat memanggil operasi GetResources untuk menanyakan sumber daya tertentu. Kode sampel:

/**
 * Tanyakan sumber daya
 * @param regionId         ID wilayah
 * @param productCode      Kode produk, yang merupakan "VPC" dalam contoh ini.
 * @param productCode      Kode produk, yang merupakan "vSwitch" dalam contoh ini.
 * @param resourceId ID sumber daya. Parameter ini menentukan ID vSwitch yang dibuat dalam contoh ini.
 * @param client           Pengguna RAM (klien)
 * @return resourceWithOptions Respons.
 */
public GetResourcesResponse getResources(String regionId, String productCode, String resourceTypeCode, String resourceId, Client client) throws Exception {
    String requestPath = "/api/v1/providers/aliyun/products/" + productCode + "/resources/" + resourceTypeCode + "/" + resourceId;
    Map<String, String> body = new HashMap<>();
    GetResourcesRequest getResourcesRequest = new GetResourcesRequest()
            .setRegionId(regionId);
    com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
    Map<String, String> headers = new HashMap<>();
    GetResourcesResponse resourcesWithOptions = client.getResourcesWithOptions(requestPath, getResourcesRequest, headers, runtime);
    return resourcesWithOptions;
}

Jika permintaan berhasil, badan berikut dikembalikan:

resourcesWithOptions.getBody()

{
  "resource": {
    "resourceId": "vsw-m5eaburrn73mdpemo****",
    "resourceAttributes": {
      "IsDefault": false,
      "Status": "Tersedia",
      "Description": "Uji pembaruan",
      "RouteTableId": "vtb-m5epr0god70hpomnn****",
      "ResourceGroupId": "rg-acfmykd63gtpfpa",
      "ZoneId": "cn-qingdao-b",
      "AvailableIpAddressCount": 252,
      "CreateTime": "2024-10-16T05:30:31Z",
      "VSwitchId": "vsw-m5eaburrn73mdpemo****",
      "CidrBlock": "172.16.24.0/24",
      "VpcId": "vpc-m5esjf3a6b380olet****",
      "VSwitchName": "",
      "RegionId": "cn-qingdao",
      "Ipv6CidrBlock": "",
      "Tags": [
        {
          "TagKey": "acs:tag:createdby",
          "TagValue": "sub:206453422934844953:user****"
        }
      ]
    }
  },
  "requestId": "B16A5BFC-20FC-5C3A-B640-6CB014328E16"
}

Hapus sumber daya

Anda dapat memanggil operasi DeleteResource untuk menghapus sumber daya tertentu. Kode sampel:

Penting

Berhati-hatilah saat Anda menghapus sumber daya untuk mencegah operasi tidak sengaja memengaruhi sumber daya lain.

/**  
 * Hapus sumber daya  
 * @param regionId         ID wilayah  
 * @param productCode      Kode produk, yang merupakan "VPC" dalam contoh ini.  
 * @param productCode      Kode produk, yang merupakan "vSwitch" dalam contoh ini.  
 * @param resourceId ID sumber daya. Parameter ini menentukan ID vSwitch yang dibuat dalam contoh ini.  
 * @param client           Pengguna RAM (klien)  
 * @return deleteResourceResponse Respons.  
 */  
public DeleteResourceResponse deleteResource(String regionId, String productCode, String resourceTypeCode, String resourceId, Client client) throws Exception {  
    String requestPath = "/api/v1/providers/Aliyun/products/" + productCode + "/resources/" + resourceTypeCode + "/" + resourceId;  
    DeleteResourceRequest deleteResourceRequest = new DeleteResourceRequest()  
            .setRegionId(regionId);  
    com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();  
    Map<String, String> headers = new HashMap<>();  
    DeleteResourceResponse deleteResourceResponse = client.deleteResourceWithOptions(requestPath, deleteResourceRequest, headers, runtime);  
    return deleteResourceResponse;  
}

Jika panggilan berhasil, statusCode=202 dikembalikan, yang menunjukkan bahwa tugas tersebut adalah operasi asinkron. Anda perlu menanyakan status tugas lebih lanjut. Untuk informasi lebih lanjut, lihat Tanyakan status tugas.
deleteResourceResponse.getBody()
```
{  
  "requestId": "A9BC357C-7ED1-5046-ADDF-4BE17C5A7064",  
  "taskId": "task-5057a4fbef2bcffe4562c2954****"  
}
```

Tanyakan status tugas

Menanyakan status tugas tertentu.

Anda dapat memanggil operasi GetTask untuk menanyakan status tugas tertentu. Contoh pemanggilan adalah untuk menanyakan tugas di mana vSwitch sedang dibuat:

/**  
 * Tanyakan tugas asinkron  
 * @param taskId ID tugas  
 * @param client Pengguna RAM (klien)  
 * @return taskWithOptions Respons.  
 */  
public GetTaskResponse getTask(String taskId, Client client) throws Exception {  
    com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();  
    Map<String, String> headers = new HashMap<>();  
    GetTaskResponse taskWithOptions = client.getTaskWithOptions(taskId, headers, runtime);  
    return taskWithOptions;  
}

Jika permintaan berhasil, status="Succeeded" dalam badan respons dikembalikan, menunjukkan bahwa vSwitch telah dibuat.

taskWithOptions.getBody()

{  
  "task": {  
    "taskAction": "Create",  
    "product": "VPC",  
    "resourceId": "vsw-m5eaburrn73mdpemo****",  
    "createTime": "2024-10-16T05:30:31Z",  
    "regionId": "cn-qingdao",  
    "resourcePath": "VSwitch/vsw-m5eaburrn73mdpemo****",  
    "taskId": "task-5057a4fbef2bcffe44d6b3590****",  
    "resourceType": "VSwitch",  
    "status": "Succeeded"  
  },  
  "requestId": "C062613B-8A99-5E69-86DB-26446D1AB845"  
}

Kode sampel lengkap

ContohDemo lengkap dalam tutorial ini adalah sebagai berikut:

ExampleDemo

package org.example;  
  
import com.alibaba.fastjson.JSONObject;  
import com.aliyun.cloudcontrol20220830.Client;  
import com.aliyun.cloudcontrol20220830.models.*;  
import com.aliyun.teaopenapi.models.Config;  
import com.aliyun.teautil.models.RuntimeOptions;  
  
import java.util.HashMap;  
import java.util.Map;  
  
/**  
 * Implementasikan manajemen sumber daya.  
 */  
public class ExampleDemo {  
  
    /**  
     * Inisialisasi klien.  
     * @return Client  
     */  
    public static Client createClient() throws Exception {  
        // Jika kode proyek bocor, pasangan AccessKey mungkin bocor dan keamanan semua sumber daya dalam akun Anda mungkin terganggu. Contoh kode sampel berikut hanya disediakan untuk referensi.   
        Config config = new Config()  
                // Wajib. Pastikan bahwa variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dikonfigurasi.   
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))  
                // Wajib. Pastikan bahwa variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET dikonfigurasi.   
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));  
        # Untuk informasi lebih lanjut tentang titik akhir, lihat https://api.aliyun.com/product/cloudcontrol.  
        config.endpoint = "cloudcontrol.aliyuncs.com";  
        return new Client(config);  
    }  
  
    /**  
     * Menanyakan produk  
     * @param client           Klien  
     * @return listProductsResponse Respons.  
     */  
    public ListProductsResponse listProducts(Client client) throws Exception {  
        ListProductsHeaders listProductsHeaders = new ListProductsHeaders();  
        ListProductsRequest listProductsRequest = new ListProductsRequest();  
        RuntimeOptions runtime = new RuntimeOptions();  
        ListProductsResponse listProductsResponse = client.listProductsWithOptions("Aliyun", listProductsRequest, listProductsHeaders, runtime);  
        return listProductsResponse;  
    }  
  
    /**  
     * Menanyakan tipe sumber daya  
     * @param productCode      Kode produk, yang merupakan "VPC" dalam contoh ini.  
     * @param client           Klien.  
     * @return listResourceTypesResponse Respons.  
     */  
    public ListResourceTypesResponse listResourceTypes(String productCode, Client client) throws Exception {  
        com.aliyun.cloudcontrol20220830.models.ListResourceTypesHeaders listResourceTypesHeaders = new com.aliyun.cloudcontrol20220830.models.ListResourceTypesHeaders();  
        com.aliyun.cloudcontrol20220830.models.ListResourceTypesRequest listResourceTypesRequest = new com.aliyun.cloudcontrol20220830.models.ListResourceTypesRequest();  
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();  
        // Tulis kode Anda sendiri untuk menampilkan respons dari operasi API jika perlu.  
        ListResourceTypesResponse listResourceTypesResponse = client.listResourceTypesWithOptions("Aliyun", productCode, listResourceTypesRequest, listResourceTypesHeaders, runtime);  
        return listResourceTypesResponse;  
    }  
  
    /**  
     * Buat sumber daya  
     * @param regionId         ID wilayah.  
     * @param productCode      Kode produk, yang merupakan "VPC" dalam contoh ini.  
     * @param resourceTypeCode Kode tipe sumber daya, yang merupakan "VPC" dalam contoh ini.  
     * @param client           Pengguna RAM (klien)  
     * @return resourceWithOptions Respons.  
     */  
    public CreateResourceResponse createResource(String regionId, String productCode, String resourceTypeCode, Client client) throws Exception {  
        String requestPath = "/api/v1/providers/Aliyun/products/" + productCode + "/resources/" + resourceTypeCode;  
        // Parameter respons  
        Map body = new HashMap();  
        body.put("Description", "Tes pembuatan");  
        com.aliyun.cloudcontrol20220830.models.CreateResourceRequest createResourceRequest = new com.aliyun.cloudcontrol20220830.models.CreateResourceRequest()  
                .setRegionId(regionId).setBody(body);  
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();  
        java.util.Map<String, String> headers = new java.util.HashMap<>();  
        CreateResourceResponse resourceWithOptions = client.createResourceWithOptions(requestPath, createResourceRequest, headers, runtime);  
        return resourceWithOptions;  
    }  
  
    /**  
     * Tanyakan tugas asinkron  
     * @param taskId ID tugas  
     * @param client Pengguna RAM (klien)  
     * @return taskWithOptions Respons.  
     */  
    public GetTaskResponse getTask(String taskId, Client client) throws Exception {  
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();  
        java.util.Map<String, String> headers = new java.util.HashMap<>();  
        GetTaskResponse taskWithOptions = client.getTaskWithOptions(taskId, headers, runtime);  
        return taskWithOptions;  
    }  
  
    /**  
     * Daftar sumber daya  
     * @param regionId         ID wilayah  
     * @param productCode      Kode produk, yang merupakan "VPC" dalam contoh ini.  
     * @param resourceTypeCode Kode tipe sumber daya, yang merupakan "VPC" dalam contoh ini.  
     * @param client           Pengguna RAM (klien)  
     * @return resourceWithOptions Respons.  
     */  
    public GetResourcesResponse getResources(String regionId, String productCode, String resourceTypeCode, Client client) throws Exception {  
        String requestPath = "/api/v1/providers/aliyun/products/" + productCode + "/resources/" + resourceTypeCode;  
        // Parameter respons.  
        Map body = new HashMap();  
        body.put("VpcId", "vpc-m5er4j63farlj8d53****");  
        com.aliyun.cloudcontrol20220830.models.GetResourcesRequest getResourcesRequest = new com.aliyun.cloudcontrol20220830.models.GetResourcesRequest()  
                .setRegionId(regionId).setFilter(body);  
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();  
        java.util.Map<String, String> headers = new java.util.HashMap<>();  
        GetResourcesResponse resourcesWithOptions = client.getResourcesWithOptions(requestPath, getResourcesRequest, headers, runtime);  
        return resourcesWithOptions;  
    }  
  
    /**  
     * Tanyakan sumber daya  
     * @param regionId         ID wilayah  
     * @param productCode      Kode produk, yang merupakan "VPC" dalam contoh ini.  
     * @param resourceTypeCode Kode tipe sumber daya, yang merupakan "vSwitch" dalam contoh ini.  
     * @param resourceId ID sumber daya. Parameter ini menentukan ID VPC yang akan dibuat dalam contoh ini.  
     * @param client           Pengguna RAM (klien)  
     * @return resourceWithOptions Respons.  
     */  
    public GetResourcesResponse getResources(String regionId, String productCode, String resourceTypeCode, String resourceId, Client client) throws Exception {  
        String requestPath = "/api/v1/providers/aliyun/products/" + productCode + "/resources/" + resourceTypeCode + "/" + resourceId;  
        com.aliyun.cloudcontrol20220830.models.GetResourcesRequest getResourcesRequest = new com.aliyun.cloudcontrol20220830.models.GetResourcesRequest()  
                .setRegionId(regionId);  
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();  
        java.util.Map<String, String> headers = new java.util.HashMap<>();  
        GetResourcesResponse resourcesWithOptions = client.getResourcesWithOptions(requestPath, getResourcesRequest, headers, runtime);  
        return resourcesWithOptions;  
    }  
  
    /**  
     * Perbarui sumber daya  
     * @param regionId         ID wilayah  
     * @param productCode      Kode produk, yang merupakan "VPC" dalam contoh ini.  
     * @param resourceTypeCode Kode tipe sumber daya, yang merupakan "VPC" dalam contoh ini.  
     * @param resourceId ID sumber daya. Parameter ini menentukan ID VPC yang akan dibuat dalam contoh ini.  
     * @param client           Pengguna RAM (klien)  
     * @return resourceWithOptions Respons.  
     */  
    public UpdateResourceResponse updateResource(String regionId, String productCode, String resourceTypeCode, String resourceId, Client client) throws Exception {  
        String requestPath = "/api/v1/providers/Aliyun/products/" + productCode + "/resources/" + resourceTypeCode + "/" + resourceId;  
        // Parameter respons.  
        Map body = new HashMap();  
        body.put("Description", "Tes pembaruan");  
        com.aliyun.cloudcontrol20220830.models.UpdateResourceRequest updateResourceRequest = new com.aliyun.cloudcontrol20220830.models.UpdateResourceRequest()  
                .setRegionId(regionId).setBody(body);  
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();  
        java.util.Map<String, String> headers = new java.util.HashMap<>();  
        UpdateResourceResponse updateResourceResponse = client.updateResourceWithOptions(requestPath, updateResourceRequest, headers, runtime);  
        return updateResourceResponse;  
    }  
  
    /**  
     * Hapus sumber daya  
     * @param regionId         ID wilayah  
     * @param productCode      Kode produk, yang merupakan "VPC" dalam contoh ini.  
     * @param resourceTypeCode Kode tipe sumber daya, yang merupakan "VPC" dalam contoh ini.  
     * @param resourceId ID sumber daya. Parameter ini menentukan ID VPC yang akan dibuat dalam contoh ini.  
     * @param client           Pengguna RAM (klien)  
     * @return deleteResourceResponse Respons.  
     */  
    public DeleteResourceResponse deleteResource(String regionId, String productCode, String resourceTypeCode, String resourceId, Client client) throws Exception {  
        String requestPath = "/api/v1/providers/Aliyun/products/" + productCode + "/resources/" + resourceTypeCode + "/" + resourceId;  
        com.aliyun.cloudcontrol20220830.models.DeleteResourceRequest deleteResourceRequest = new com.aliyun.cloudcontrol20220830.models.DeleteResourceRequest()  
                .setRegionId(regionId);  
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();  
        java.util.Map<String, String> headers = new java.util.HashMap<>();  
        DeleteResourceResponse deleteResourceResponse = client.deleteResourceWithOptions(requestPath, deleteResourceRequest, headers, runtime);  
        return deleteResourceResponse;  
    }  
}