CreateVcc

Updated at:

You can create a Lingjun connection to connect Lingjun network environment and Alibaba Cloud network environment.

Operation description

When you call this operation to create a Lingjun connection, note that:

  • When you specify the vccId parameter, the system will configure the purchased Lingjun connection for you. When the default vccId parameter is set, the system will automatically place an order and configure the Lingjun connection for you.

  • Make sure that you have called the InitializeVcc operation to grant permissions.

  • This interface is an asynchronous interface. After this interface is called, the system will return the Lingjun connection ID, but the Lingjun connection instance may not be created yet, and the system background creation task is still in progress. You can call the ListVccs or GetVcc operation to query the status of the Lingjun connection.

    • If the status of the Lingjun connection is Executed, the Lingjun connection is being created.

    • If the status of the Lingjun connection is Available, the Lingjun connection is created.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

eflo:CreateVcc

create

*Vcc

acs:eflo:{#regionId}:{#accountId}:Vcc/*

None None

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

No

The region ID.

cn-wulanchabu

ZoneId

string

No

The zone ID of the disk.

cn-wulanchabu-a

VccName

string

No

Lingjun Connection Name

test

VpdId

string

No

Lingjun CIDR block instance ID

vpd-t2jseldp

CenId

string

No

CEN Instance ID

cen-bkiw0x1347roekr7f2

Description

string

No

The description of the document.

vpd for test

Bandwidth

integer

No

The bandwidth. Unit: Mbit /s. The minimum value is 1000, representing 1Gbps bandwidth; the maximum value is 400000, representing 400Gbps bandwidth.

Note

1Gbps = 1000Mbps

1000

Tag

array<object>

No

The tag information.

You can specify up to 20 tags.

object

No

Details of the tag.

Key

string

No

The tag key of the VPN attachment.

You cannot specify an empty string as a tag key. It can be up to 64 characters in length and cannot start with aliyun or acs:. It cannot contain http:// or https://.

You can specify at most 20 tag keys in each call.

tag-vcc

Value

string

No

The tag value of the VPN connection.

The tag value can be empty or a string of up to 128 characters. It cannot start with aliyun or acs:, and cannot contain http:// or https://.

Each key-value pair must be unique. You can specify values for at most 20 tag keys in each call.

vcc-group-1

VccId

string

No

The ID of the Lingjun connection instance.

vcc-cn-zvp2w222001

VpcId

string

No

Virtual Private Cloud IDs; What is Virtual Private Cloud

You can call the DescribeVpcs operation to query the specified VPC.

vpc-uf6aa4ddo97frj22tgp52

ResourceGroupId

string

No

The resource group ID.

For more information about resource groups, see Resource groups.

rg-aeky5f3qx6ceapq

ConnectionType

string

No

The connection mode. Valid values:

  • VPC

  • CEN (CENTR)

CENTR

VSwitchId

string

No

The ID of the vSwitch. Virtual Private Cloud VSwitch.

You can call the DescribeVSwitches operation to query created vSwitches.

vsw-t4nahb0pxckgktx1kot8q

BgpCidr

string

No

Internet segment, on-premises input, off-premises default

10.0.0.0/24

AccessCouldService

boolean

No

Enabled access to cloud services. Optional values:

  • true: Enable access to cloud services

  • false: Do not enable access to cloud services

true

CenOwnerId

string

No

Account to which cen belongs

1511928242963727

BgpAsn

integer

No

bgp as number

4200057312

Response elements

Element

Type

Description

Example

object

AjaxResult

Code

integer

The response status code.

0

Message

string

response message, if the success request is

success

RequestId

string

Request ID of the current request

039C3C3A-3C37-5672-80D5-D8CD48C676D1

Content

object

The returned data.

VccId

string

The ID of the Lingjun connection instance.

vcc-cn-zvp2w222001

AccessDeniedDetail

string

The detailed information about the failed permission verification.

None

Examples

Success response

JSON format

{
  "Code": 0,
  "Message": "success",
  "RequestId": "039C3C3A-3C37-5672-80D5-D8CD48C676D1",
  "Content": {
    "VccId": "vcc-cn-zvp2w222001"
  },
  "AccessDeniedDetail": "None"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.