uip admin integrations vpn

Syntax and options for `uip admin integrations vpn`, which manages VPN gateways and site-to-site connections that let cloud and serverless robots reach on-prem networks privately.

uip admin integrations vpn manages VPN gateways and their site-to-site connections. A VPN gateway lets cloud and serverless robots reach on-prem networks privately over a site-to-site IPsec tunnel, hosted in a network whose address space you provide at create time. A gateway can have multiple connections, each peering the gateway with one on-prem network.

This command tree is implemented by the separately-published @uipath/admin-vpngateway-commands package, one of several packages composed into uip admin (see the uip admin overview) — it owns no top-level CLI verb of its own; integrations is a shared parent namespace other admin integration tools may register under later.

概念

• Asynchronous operations. Every mutating verb (create, edit, redeploy, delete, refresh) returns as soon as the task is enqueued, not once it's applied. Poll gateways get <key> / connections get <key> until state reaches a terminal value (Deployed for a gateway, anything other than Connecting/Updating for a connection) before issuing the next mutation. Concurrent mutations on the same gateway return HTTP 409 — wait a few seconds and retry.
• Destructive verbs require --confirm. gateways delete and connections delete refuse to run without it, specifically so non-interactive callers can't trigger deletion by accident. connections edit also requires --confirm on every call, since most edits cause a brief tunnel renegotiation and connectivity drop.
• List-replace semantics on edit. For both gateways edit and connections edit, list-shaped flags (--dns-server, --apipa-address, --trusted-cert, --target-address-space) replace the existing list wholesale when passed — re-pass every entry you want to keep. Each has a matching --clear-* flag to empty the list explicitly, mutually exclusive with the populated form.
• connections edit always requires --shared-key. Even when you're not changing it, you must re-supply the current pre-shared key on every edit call — the backend has no partial-update path for it.
• IPsec policy is all-or-nothing. If you set any of the 8 IPsec/IKE flags (--ipsec-sa-lifetime, --ipsec-sa-data-size, --ipsec-encryption, --ipsec-integrity, --ike-encryption, --ike-integrity, --dh-group, --pfs-group), you must set all 8. A GCMAES --ipsec-encryption variant requires an identical GCMAES --ipsec-integrity. connections edit preserves the existing policy by default; pass all 8 flags to replace it, or --clear-ipsec to remove it (mutually exclusive with the 8 flags).
• BGP pairing convention. --bgp-peer-address (the on-prem device's BGP endpoint) must be the /30 partner of an address in the gateway's --apipa-address pool, both drawn from 169.254.21.0/24 or 169.254.22.0/24. Convention: the gateway takes the higher usable address of the /30 (e.g. .10), the on-prem peer takes the lower (e.g. .9). Enabling BGP on a connection that wasn't BGP-enabled before requires passing both --asn and --bgp-peer-address together — the CLI rejects the edit upfront otherwise.
• --vnet-address-space is immutable after gateways create and must be a CIDR with prefix between /8 and /27; the 169.254.0.0/16 APIPA range is rejected because it collides with the BGP APIPA blocks used internally.

概要

uip admin integrations vpn gateways list [--tenant <name>]
uip admin integrations vpn gateways get <key> [--tenant <name>]
uip admin integrations vpn gateways tenant-config [--tenant <name>]
uip admin integrations vpn gateways create --name <name> --vnet-address-space <cidr> [--description <text>] [--dns-server <ip>]... [--apipa-address <ip>]... [--trusted-cert <name=base64>]... [--tenant <name>]
uip admin integrations vpn gateways edit <key> [--name <name>] [--description <text>] [--dns-server <ip>]... [--clear-dns-servers] [--apipa-address <ip>]... [--clear-apipa-addresses] [--trusted-cert <name=base64>]... [--clear-trusted-certs] [--tenant <name>]
uip admin integrations vpn gateways redeploy <key> [--tenant <name>]
uip admin integrations vpn gateways delete <key> --confirm [--tenant <name>]

uip admin integrations vpn connections get <key> [--tenant <name>]
uip admin integrations vpn connections create <gateway-key> --name <name> --shared-key <key> --target-ip <ip> [--target-address-space <cidr>]... [--bgp-enabled --asn <num> --bgp-peer-address <ip>] [ipsec flags...] [--tenant <name>]
uip admin integrations vpn connections edit <key> --shared-key <key> --confirm [options...]
uip admin integrations vpn connections refresh <key> [--tenant <name>]
uip admin integrations vpn connections delete <key> --confirm [--tenant <name>]

--tenant <name> is available on every verb in both groups (defaults to the tenant in your login context).

uip admin integrations vpn gateways

uip admin integrations vpn gateways list

List all VPN gateways for the current tenant — key, name, state, type, SKU, VNet, location, public IP, connection count.

オプション

長押し	値 (Value)	説明
--tenant <name>	string	Target tenant. Defaults to your login context.

例

uip admin integrations vpn gateways list

データシェイプ(--output json)

{
  "Code": "VpnGatewayList",
  "Data": {
    "count": 1,
    "value": [
      {
        "key": "00000000-0000-0000-0000-000000000001",
        "name": "prod-gw",
        "state": "Deployed",
        "gatewayType": "Vpn",
        "sku": "Basic",
        "vnetAddressSpace": "10.0.0.0/24",
        "location": "westus",
        "publicIp": "20.0.0.1",
        "connections": []
      }
    ]
  }
}

uip admin integrations vpn gateways get

Fetch a gateway and its connections by key.

引数

名前	Required	目的
<key>	○	VPN gateway key (GUID).

例

uip admin integrations vpn gateways get 00000000-0000-0000-0000-000000000001

データシェイプ(--output json)

{
  "Code": "VpnGatewayGet",
  "Data": {
    "key": "00000000-0000-0000-0000-000000000001",
    "name": "prod-gw",
    "state": "Deployed",
    "gatewayType": "Vpn",
    "sku": "Basic",
    "vnetAddressSpace": "10.0.0.0/24",
    "location": "westus",
    "publicIp": "20.0.0.1",
    "connections": [
      { "key": "11111111-1111-1111-1111-111111111111", "name": "site-a", "state": "Connected", "targetIpAddress": "203.0.113.10" }
    ],
    "trustedCertificates": [
      { "name": "corp-root-ca", "publicCertificateData": "MIIDazCCAlOgAwIBAgIUHs9..." }
    ]
  }
}

uip admin integrations vpn gateways tenant-config

Check whether the current tenant is allowed to provision a VPN gateway.

例

uip admin integrations vpn gateways tenant-config

データシェイプ(--output json)

{ "Code": "VpnGatewayTenantConfig", "Data": { "canCreateVpnGateway": true } }

Data also carries validationError when canCreateVpnGateway is false.

uip admin integrations vpn gateways create

Provision a new VPN gateway. Asynchronous — track state with gateways get/list; on Failed, use gateways redeploy.

オプション

長押し	値 (Value)	Required	説明
--name <name>	string	○	Gateway name.
--vnet-address-space <cidr>	CIDR, /8–/27	○	VNet address space. Immutable after create. Rejects the 169.254.0.0/16 APIPA range.
--description <text>	string	×	Free-form description.
--dns-server <ip>	IPv4, repeatable, max 3	×	DNS server IP.
--apipa-address <ip>	IPv4 in 169.254.21.0/24 or 169.254.22.0/24, repeatable, max 2	×	APIPA BGP peering address.
--trusted-cert <cert-name=base64>	<name>=<base64-X509>, repeatable, max 10	×	Trusted root certificate.
--tenant <name>	string	×	対象のテナント。

例

uip admin integrations vpn gateways create --name prod-gw --vnet-address-space 10.0.0.0/24

# Full lifecycle: provision, wait for Deployed, then attach a BGP connection
ROOT=$(cat root.b64); INTER=$(cat inter.b64)
GW_KEY=$(uip admin integrations vpn gateways create \
  --name prod-gw \
  --vnet-address-space 10.0.0.0/24 \
  --dns-server 172.23.0.105 --dns-server 172.23.2.89 \
  --apipa-address 169.254.21.10 \
  --trusted-cert "Root=$ROOT" --trusted-cert "Inter=$INTER" \
  --output-filter Data.key --output plain)
until uip admin integrations vpn gateways get $GW_KEY \
  --output-filter Data.state --output plain | grep -q Deployed; do
  sleep 30
done
uip admin integrations vpn connections create $GW_KEY \
  --name site-a --shared-key "MyS3cr3tP4ssphr4se" \
  --target-ip 203.0.113.10 \
  --bgp-enabled --asn 65001 --bgp-peer-address 169.254.21.9

データシェイプ(--output json)

{
  "Code": "VpnGatewayCreated",
  "Data": {
    "key": "00000000-0000-0000-0000-000000000001",
    "name": "prod-gw",
    "state": "Provisioning",
    "gatewayType": "Vpn",
    "sku": "Basic",
    "vnetAddressSpace": "10.0.0.0/24"
  }
}

uip admin integrations vpn gateways edit

Update a gateway's mutable fields. Scalars you don't pass are preserved; lists you pass replace the existing list wholesale (see Concepts). Fails if no edit field is provided.

引数

名前	Required	目的
<key>	○	VPN gateway key (GUID).

オプション

長押し	値 (Value)	説明
--name <name>	string	Rename the gateway.
--description <text>	string	Update description.
--dns-server <ip>	IPv4, repeatable, max 3	Replace the DNS server list. Mutually exclusive with --clear-dns-servers.
--clear-dns-servers	フラグ	Remove all DNS servers.
--apipa-address <ip>	IPv4, repeatable, max 2	Replace the APIPA address list. Mutually exclusive with --clear-apipa-addresses.
--clear-apipa-addresses	フラグ	Remove all APIPA BGP addresses.
--trusted-cert <cert-name=base64>	repeatable, max 10	Replace the trusted certificate list. Mutually exclusive with --clear-trusted-certs.
--clear-trusted-certs	フラグ	Remove all trusted certificates.
--tenant <name>	string	対象のテナント。

例

uip admin integrations vpn gateways edit 00000000-0000-0000-0000-000000000001 --name new-name

uip admin integrations vpn gateways edit 00000000-0000-0000-0000-000000000001 --clear-dns-servers

データシェイプ(--output json)

{
  "Code": "VpnGatewayEdited",
  "Data": { "key": "00000000-0000-0000-0000-000000000001", "name": "new-name" }
}

Data only echoes back the fields that changed.

uip admin integrations vpn gateways redeploy

Retry the last background task on a gateway whose previous deployment attempt didn't complete cleanly. Rejected if the gateway is frozen, has a task in flight, or is in an unsupported state.

引数

名前	Required	目的
<key>	○	VPN gateway key (GUID).

例

uip admin integrations vpn gateways redeploy 00000000-0000-0000-0000-000000000001

データシェイプ(--output json)

{ "Code": "VpnGatewayRedeployRequested", "Data": { "Key": "00000000-0000-0000-0000-000000000001" } }

uip admin integrations vpn gateways delete

Delete the gateway and all related infrastructure. Destructive and irreversible.

引数

名前	Required	目的
<key>	○	VPN gateway key (GUID).

オプション

長押し	値 (Value)	Required	説明
--confirm	フラグ	○	Required — the command refuses without it.
--tenant <name>	string	×	対象のテナント。

例

uip admin integrations vpn gateways delete 00000000-0000-0000-0000-000000000001 --confirm

データシェイプ(--output json)

{ "Code": "VpnGatewayDeleted", "Data": { "Key": "00000000-0000-0000-0000-000000000001" } }

uip admin integrations vpn connections

Site-to-site connections attached to a VPN gateway. Each connection peers one on-prem network with the gateway.

uip admin integrations vpn connections get

引数

名前	Required	目的
<key>	○	VPN gateway connection key (GUID).

例

uip admin integrations vpn connections get 00000000-0000-0000-0000-000000000001

データシェイプ(--output json)

{
  "Code": "VpnGatewayConnectionGet",
  "Data": {
    "key": "00000000-0000-0000-0000-000000000001",
    "name": "site-a",
    "state": "Connected",
    "targetIpAddress": "203.0.113.10",
    "targetAddressSpaces": ["192.168.1.0/24"],
    "bgpEnabled": false
  }
}

uip admin integrations vpn connections create

Attach a new site-to-site connection to a gateway.

引数

名前	Required	目的
<gateway-key>	○	Parent VPN gateway key (GUID).

オプション

長押し	値 (Value)	Required	説明
--name <name>	string	○	Connection name.
--shared-key <key>	string, ≤128 printable ASCII chars, no spaces/dashes/tildes	○	Pre-shared key.
--target-ip <ip>	IPv4	○	On-prem VPN device public IP.
--target-address-space <cidr>	CIDR, repeatable	conditionally	Required (at least one) when --bgp-enabled is not set. 0.0.0.0/0 is rejected.
--bgp-enabled	フラグ	×	Use BGP for dynamic routing.
--asn <num>	positive integer	conditionally	Required with --bgp-enabled. 65515 and 64512 are reserved.
--bgp-peer-address <ip>	IPv4	conditionally	Required with --bgp-enabled. Must be the on-prem /30 partner of a gateway --apipa-address.
--ipsec-sa-lifetime <seconds>	integer, min 300	×	IPsec SA lifetime. All-or-nothing with the 7 flags below.
--ipsec-sa-data-size <kb>	integer, 0 or 1024–2147483647	×	IPsec SA data size.
--ipsec-encryption <alg>	None|AES128|AES192|AES256|GCMAES128|GCMAES192|GCMAES256	×	IPsec encryption algorithm.
--ipsec-integrity <alg>	MD5|SHA1|SHA256|SHA384|GCMAES128|GCMAES256	×	Must match a GCMAES --ipsec-encryption exactly.
--ike-encryption <alg>	AES128|AES192|AES256|GCMAES128|GCMAES256	×	IKE encryption algorithm.
--ike-integrity <alg>	MD5|SHA1|SHA256|SHA384|GCMAES128|GCMAES256	×	IKE integrity algorithm.
--dh-group <group>	None|DHGroup1|DHGroup2|DHGroup14|DHGroup24|DHGroup2048|ECP256|ECP384	×	Diffie-Hellman group.
--pfs-group <group>	None|PFS1|PFS2|PFS14|PFS24|PFS2048|ECP256|ECP384|PFS	×	Perfect Forward Secrecy group.
--tenant <name>	string	×	対象のテナント。

例

# Static routes, no BGP
uip admin integrations vpn connections create 00000000-0000-0000-0000-0000000000aa \
  --name site-a --shared-key 'MyS3cr3tP4ssphr4se' \
  --target-ip 203.0.113.10 --target-address-space 192.168.1.0/24

# With BGP
uip admin integrations vpn connections create 00000000-0000-0000-0000-0000000000aa \
  --name site-a --shared-key 'MyS3cr3tP4ssphr4se' \
  --target-ip 203.0.113.10 --bgp-enabled --asn 65001 --bgp-peer-address 169.254.21.1

データシェイプ(--output json)

{
  "Code": "VpnGatewayConnectionCreated",
  "Data": {
    "key": "00000000-0000-0000-0000-000000000001",
    "name": "site-a",
    "state": "Connecting",
    "targetIpAddress": "203.0.113.10",
    "bgpEnabled": true,
    "asn": 65001
  }
}

uip admin integrations vpn connections edit

Update a connection's mutable fields. --shared-key and --confirm are required on every call regardless of what else changes (see Concepts).

引数

名前	Required	目的
<key>	○	VPN gateway connection key (GUID).

オプション

長押し	値 (Value)	Required	説明
--shared-key <key>	string	○	Re-supply the current pre-shared key on every edit.
--confirm	フラグ	○	Acknowledge the brief connectivity drop most edits cause.
--name <name>	string	×	Rename the connection.
--target-ip <ip>	IPv4	×	On-prem VPN device public IP.
--target-address-space <cidr>	repeatable	×	Replace the on-prem CIDR list. 0.0.0.0/0 rejected. Mutually exclusive with --clear-target-address-spaces.
--clear-target-address-spaces	フラグ	×	Remove all target address spaces. A non-BGP connection with none is misconfigured.
--bgp-enabled / --no-bgp-enabled	フラグ	×	Enable/disable BGP. Enabling on a previously-non-BGP connection requires --asn and --bgp-peer-address together.
--asn <num>	integer	×	BGP ASN.
--bgp-peer-address <ip>	IPv4	×	BGP peer address.
--ipsec-sa-lifetime--ipsec-sa-data-size、--ipsec-encryption、--ipsec-integrity、--ike-encryption、--ike-integrity、--dh-group、--pfs-group	see connections create	×	Pass all 8 to replace the IPsec policy; omit all 8 to preserve it.
--clear-ipsec	フラグ	×	Remove the IPsec policy. Mutually exclusive with the 8 IPsec/IKE flags.
--tenant <name>	string	×	対象のテナント。

例

uip admin integrations vpn connections edit 00000000-0000-0000-0000-000000000001 \
  --shared-key 'MyS3cr3tP4ssphr4se' --name new-name --confirm

uip admin integrations vpn connections edit 00000000-0000-0000-0000-000000000001 \
  --shared-key 'MyS3cr3tP4ssphr4se' --no-bgp-enabled --confirm

データシェイプ(--output json)

{
  "Code": "VpnGatewayConnectionEdited",
  "Data": { "key": "00000000-0000-0000-0000-000000000001", "name": "new-name" }
}

uip admin integrations vpn connections refresh

Queue a background refresh of the connection's state from Azure — connections also refresh automatically on a periodic job; use this only when you don't want to wait for the next cycle. Rejected if another operation is in flight.

引数

名前	Required	目的
<key>	○	VPN gateway connection key (GUID).

例

uip admin integrations vpn connections refresh 00000000-0000-0000-0000-000000000001

データシェイプ(--output json)

{ "Code": "VpnGatewayConnectionRefreshRequested", "Data": { "Key": "00000000-0000-0000-0000-000000000001" } }

uip admin integrations vpn connections delete

Delete the connection. Destructive and irreversible — the on-prem peer must reconnect to a recreated connection afterward.

引数

名前	Required	目的
<key>	○	VPN gateway connection key (GUID).

オプション

長押し	値 (Value)	Required	説明
--confirm	フラグ	○	Required — the command refuses without it.
--tenant <name>	string	×	対象のテナント。

例

uip admin integrations vpn connections delete 00000000-0000-0000-0000-000000000001 --confirm

データシェイプ(--output json)

{ "Code": "VpnGatewayConnectionDeleted", "Data": { "Key": "00000000-0000-0000-0000-000000000001" } }

参照

• uip admin overview
• グローバル オプション
• 終了コード