Transit Gateway CLI

IBM Cloud® Transit Gateway 명령줄은 Transit Gateway 서비스에 대한 인터페이스를 제공합니다. CLI를 사용하여 게이트웨이 및 연결을 작성하고 관리하며 게이트웨이의 사용 가능한 위치를 나열할 수 있습니다.

시작하기 전에

IBM Cloud CLI 플러그인으로 구현된 Transit Gateway 명령행 인터페이스를 사용하려면 다음 지시사항을 따르십시오.

IBM Cloud CLI를 설치하십시오.
IBM Cloud CLI에 tg-cli/tg CLI 플러그인을 설치하십시오.

설치하려면 다음을 수행합니다.
```
ibmcloud plugin install tg
```

VPE(가상 개인용 엔드포인트)와 CLI를 함께 사용하려는 경우 다음 변수를 설정해야 합니다.

export IBMCLOUD_TG_API_ENDPOINT=private.transit.cloud.ibm.com

`ibmcloud plugin show tg`

Transit Gateway CLI 플러그인 정보를 표시합니다.

ibmcloud plugin show tg

Transit Gateway

이 섹션에서는 게이트웨이 기능에 대한 CLI 명령어에 대한 정보를 제공합니다.

`ibmcloud tg gateway`

특정 게이트웨이에 대한 세부사항을 검색합니다.

ibmcloud tg gateway|gw GATEWAY_ID [--output json] [-h, --help]

명령 옵션

GATEWAY_ID: 자세한 정보를 확인하려는 게이트웨이의 ID입니다.
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

게이트웨이에 대한 세부사항을 요청합니다.

ibmcloud tg gw $gateway

`ibmcloud tg gateways`

Transit Gateway를 나열합니다.

ibmcloud tg gateways|gws [--output json] [-h, --help]

명령 옵션

--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

다른 명령은 게이트웨이 ID가 필요합니다. 나중에 사용할 수 있도록 ID를 환경 변수로 저장하세요. 예를 들어:

gateway="bdf8fa2b-c518-9999-9028-f3c9ece86159"

`ibmcloud tg gateway-create`

Transit Gateway를 작성하십시오.

ibmcloud tg gateway-create|gwc --name NAME --location LOCATION [--routing ROUTING][--gre-enhanced-route-propagation true | false] [--resource-group-id RES_GROUP_ID] [--output json] [-h, --help]

명령 옵션

--name: 새 게이트웨이의 이름.
--location: 게이트웨이 위치 ( ibmcloud tg locations 를 사용하여 가능한 값을 확인하세요)
--routing: 자원 게이트웨이 라우팅(global | local). 지역 간 자원을 연결하려면 global 을 선택하십시오. 기본값은 local입니다.
--resource-group-id: 선택 사항: 게이트웨이 리소스 그룹 ID. 지정하지 않을 경우 기본 리소스 그룹이 사용됩니다.
--gre-enhanced-route-propagation: 선택 사항입니다: 동일한 트랜짓 게이트웨이에 연결된 모든 GRE에서 경로 전파를 활성화할지 여부를 지정합니다. 유효한 값은 true 및 false (기본값)입니다.
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

us-south 에서 myGateway 라는 게이트웨이를 만들고, local 라우팅을 사용하고, 기본 리소스 그룹을 사용하도록 설정합니다.

ibmcloud tg gwc --name myGateway --location us-south

`ibmcloud tg gateway-delete`

기존 게이트웨이를 삭제합니다.

ibmcloud tg gateway-delete|gwd GATEWAY_ID [-f, --force] [-h, --help]

명령 옵션

GATEWAY_ID: 삭제하려는 게이트웨이의 ID.
--force | -f: 선택 사항: 확인 없이 강제로 삭제합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

확인 없이 게이트웨이를 삭제합니다.

ibmcloud tg gwd $gateway -f

`ibmcloud tg gateway-update`

기존 게이트웨이에 대한 특성을 업데이트합니다.

ibmcloud tg gateway-update|gwu GATEWAY_ID [--name NAME] [--routing ROUTING] [--gre-enhanced-route-propagation true | false] [--output json] [-h, --help]

명령 옵션

GATEWAY_ID

업데이트하려는 게이트웨이의 ID.

--name

선택 사항: 게이트웨이의 새 이름.

--routing

선택 사항: 리소스의 게이트웨이 라우팅(global | local). 전역 연결을 선택하여 여러 지역에 걸쳐 리소스를 연결합니다. global 에서 local 로 라우팅을 변경하려면 모든 기존 연결이 local 로 되어 있어야 합니다.

--gre-enhanced-route-propagation

선택 사항입니다: 동일한 트랜짓 게이트웨이에 연결된 모든 GRE에서 경로 전파를 활성화할지 여부를 지정합니다. 유효한 값은 true 및 false (기본값)입니다.

이 값을 변경한 후 변경 사항이 적용될 때까지 몇 분 정도 기다리세요.

--output json

선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.

--help | -h

선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

게이트웨이를 global 라우팅 값으로 업데이트하십시오.

ibmcloud tg gwu $gateway --routing global

연결

이 섹션에서는 연결 기능에 대한 CLI 명령어에 대한 정보를 제공합니다.

`ibmcloud tg acc-connections`

트랜짓 게이트웨이의 모든 계정 연결을 나열합니다.

ibmcloud tg acc-connections|ac [--network-id NETWORK_ID] [--network-type NETWORK_TYPE] [--all-pages] [--limit NUMERIC_VALUE] [--output json] [-h, --help]

명령 옵션

--network-id

선택사항입니다. classic 의 경우 값을 설정하지 마세요. 다른 모든 네트워크 유형에 CRN을 사용하십시오. 예를 들어, VPC의 CRN을 확인하려면:

ibmcloud is vpc VPC_ID --json

--network-type: 선택사항입니다. 연결의 네트워크 유형. 값은 classic, directlink, power_virtual_server, vpn_gateway, vpc 입니다.
--all-pages: 선택 사항입니다: --limit 크기 지정 여부와 관계없이 모든 연결을 나열합니다.
--limit NUMERIC_VALUE: 선택 사항입니다: 페이지당 반환할 최대 리소스 수입니다. 기본 제한은 50 입니다. 가능한 값: 1 ≤ 값 ≤ 500
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예제

모든 계정 연결을 나열합니다:

ibmcloud tg acc-connections|ac

네트워크 유형별로 필터링된 계정 연결을 나열합니다:

ibmcloud tg acc-connections|ac --network-type vpc|classic|directlink|vpn_gateway|power_virtual_server

`ibmcloud tg connection`

특정 연결에 대한 세부사항을 검색합니다.

ibmcloud tg connection|c GATEWAY_ID CONNECTION_ID [--output json] [-h, --help]

명령 옵션

GATEWAY_ID: 연결이 이루어진 게이트웨이의 ID.
CONNECTION_ID: 자세한 정보를 확인하려는 연결의 ID입니다.
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

특정 연결 ID에 대한 세부사항을 요청합니다.

ibmcloud tg c $gateway $connection

`ibmcloud tg connections`

트랜짓 게이트웨이의 연결 목록을 표시합니다.

ibmcloud tg connections|cs GATEWAY_ID [--all-pages] [--limit NUMERIC_VALUE] [--output json] [-h, --help]

명령 옵션

GATEWAY_ID: 연결을 허용할 게이트웨이의 ID입니다.
--all-pages (현재 이용 가능 여부 선택): --limit 의 크기가 지정되었는지 여부에 관계없이 모든 연결을 나열합니다.
--limit (현재 이용 가능 여부 선택): 페이지당 반환할 최대 리소스 수입니다. 기본 제한은 100 입니다. 가능한 값: 1 ≤ 값 ≤ 500
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

게이트웨이에 대한 연결을 나열합니다.

ibmcloud tg cs $gateway

다른 명령은 연결 ID가 필요합니다. 나중에 사용할 수 있도록 ID를 환경 변수로 저장하세요. 예를 들어:

connection="4892849f-368e-9999-bb58-8888fb21e513"

`ibmcloud tg connection-create`

트랜짓 게이트웨이에서 연결을 생성합니다.

ibmcloud tg connection-create|cc GATEWAY_ID --name NAME --network-id NETWORK_ID --network-type NETWORK_TYPE --network-account-id ACCOUNT_ID [--zone ZONE] [--default-prefix-filter DEFAULT_PREFIX_FILTER] [--cidr CIDR] [--output json]

명령 옵션

GATEWAY_ID: 새 연결이 설정된 게이트웨이의 ID입니다.
--name: 새 연결의 이름.
--network-id: 네트워크 연결의 ID. classic 의 경우 값을 설정하지 마세요. 다른 모든 네트워크 유형에 CRN을 사용하십시오. 예를 들어, VPC의 CRN을 확인하려면:

ibmcloud is vpc VPC_ID --json

--network-type: 연결의 네트워크 유형. 값은 classic, directlink, power_virtual_server, vpn_gateway, vpc 입니다.
--network-account-id: 클래식 연결을 생성하는 데 사용할 IBM Cloud 계정의 ID입니다. 연결 계정이 게이트웨이 계정과 다른 경우, ‘ classic ’ 유형에서만 사용됩니다.
--zone: 선택 사항: GRE 터널 또는 VPN 연결이 배포될 가용성 영역. vpn_gateway 네트워크 유형에만 적용됩니다.
--default-prefix-filter: 선택 사항: 연결의 기본 접두사 필터 (permit | deny).
--cidr: 선택 사항: 연결에 사용할 CIDR 블록. vpn_gateway 네트워크 유형에만 적용됩니다.
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

vpc-connection 라는 이름의 VPC 연결을 만들고, vpcCRN="crn:v1:bluemix:public:is:us-south:a/3aa0a9999a1a46258064d84f7f447920::vpc:r134-f87014d5-87d2-46d1-9999-24683082f6bc"

ibmcloud tg cc $gateway --name vpc-connection --network-id $vpcCRN --network-type vpc

classic-conn(이)라는 클래식 연결을 작성하십시오.

ibmcloud tg cc $gateway --name classic-conn --network-type classic

`ibmcloud tg connection-delete`

기존 연결을 삭제합니다.

ibmcloud tg connection-delete|cd GATEWAY_ID CONNECTION_ID [-f, --force] [-h, --help]

명령 옵션

GATEWAY_ID: 삭제되는 연결의 게이트웨이 ID입니다.
CONNECTION_ID: 삭제되는 연결의 ID입니다.
--force | -f: 선택 사항: 확인 없이 강제로 삭제합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

확인 없이 연결을 삭제합니다.

ibmcloud tg cd $gateway $connection -f

`ibmcloud tg connection-create-gre`(더 이상 사용되지 않음)

이 명령은 더 이상 사용되지 않습니다. Tg-connection-gre-create 명령어를 사용하십시오.

트랜짓 게이트웨이에서 GRE(Generic Routing Encapsulation) 터널 연결을 생성합니다.

ibmcloud tg connection-rcreate-gre|crgre GATEWAY_ID --name NAME --zone ZONE --local-gateway-ip LOCAL_GATEWAY_IP --local-tunnel-ip LOCAL_TUNNEL_IP --remote-gateway-ip REMOTE_GATEWAY_IP --remote-tunnel-ip REMOTE_TUNNEL_IP [--base-connection-id BASE_CONNECTION_ID] [--base-network-type BASE_NETWORK_TYPE] [--network-type NETWORK_TYPE] [--network-account-id NETWORK_ACCOUNT_ID] [--remote-bgp-asn REMOTE_BGP_ASN] [--default-prefix-filter DEFAULT_PREFIX_FILTER] [--output json]

명령 옵션

GATEWAY_ID 새 연결이 바인딩된 게이트웨이의 ID입니다.

--name: 새로운 GRE 연결의 이름입니다.
--zone: GRE 터널의 가용성 영역. 예: us-south-1
--local-gateway-ip: GRE 터널 연결을 위한 로컬 게이트웨이 IP 주소.
--local-tunnel-ip: GRE 터널 연결을 위한 로컬 터널 IP 주소.
--remote-gateway-ip: GRE 터널 연결을 위한 원격 게이트웨이 IP 주소.
--remote-tunnel-ip: GRE 터널 연결을 위한 원격 터널 IP 주소.
--base-connection-id: 선택 사항: GRE 터널의 언더레이 역할을 하는 기존 네트워크 연결의 ID. 이 옵션은 네트워크 유형이 " gre_tunnel "인 경우에만 사용할 수 있습니다.
--base-network-type: 기본 연결의 네트워크 유형 (classic).
--network-type: 선택 사항: GRE 연결의 네트워크 유형. 기본값은 gre_tunnel입니다.
--network-account-id: 선택 사항: 클래식 연결에 연결할 계정의 ID. 연결 계정이 게이트웨이 계정과 다른 경우에만 ‘ classic ’ 유형으로만 사용하십시오.
--remote-bgp-asn: 선택 사항: 원격 BGP ASN이 지정되지 않은 경우, ASN이 생성됩니다.
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예제

gre-connection 라는 이름의 GRE 터널 연결을 생성하고, 기본 연결로 클래식 연결 9037f710-8dfb-4948-a2bd-847c8dde96d3 을 사용하도록 설정합니다.

ibmcloud tg connection-create-gre $gateway --name gre-connection --base-connection-id 9037f710-8dfb-9999-a2bd-847c8dde96d3  --zone us-south-2 --local-gateway-ip 192.168.100.1 --local-tunnel-ip 192.168.101.1 --remote-gateway-ip 10.242.63.12 --remote-tunnel-ip 192.168.101.2

`ibmcloud tg connection-approve`

네트워크 소유자로서 다른 계정에서의 연결을 승인합니다.

ibmcloud tg connection-approve|ca GATEWAY_ID CONNECTION_ID [-h, --help]

명령 옵션

GATEWAY_ID: 연결이 이루어진 게이트웨이의 ID.
CONNECTION_ID: 승인하려는 연결의 ID입니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

연결 요청을 승인합니다.

ibmcloud tg ca $gateway $connection

`ibmcloud tg connection-gre-create`

중계 게이트웨이에서 일반 라우팅 캡슐화(GRE) 터널 또는 언바운드 GRE 연결을 생성합니다.

ibmcloud tg connection-gre-create|cgrec GATEWAY_ID --name NAME --zone ZONE --local-gateway-ip LOCAL_GATEWAY_IP --local-tunnel-ip LOCAL_TUNNEL_IP --remote-gateway-ip REMOTE_GATEWAY_IP --remote-tunnel-ip REMOTE_TUNNEL_IP [--base-connection-id BASE_CONNECTION_ID] [--base-network-type BASE_NETWORK_TYPE] [--network-type NETWORK_TYPE] [--network-account-id NETWORK_ACCOUNT_ID] [--remote-bgp-asn REMOTE_BGP_ASN] [--default-prefix-filter DEFAULT_PREFIX_FILTER] [--output json]

명령 옵션

GATEWAY_ID: 새 연결이 바인딩된 게이트웨이의 ID입니다.
--name: 새로운 GRE 연결의 이름입니다.
--zone: GRE 터널의 가용성 영역. 예: us-south-1
--local-gateway-ip: GRE 터널 연결을 위한 로컬 게이트웨이 IP 주소.
--local-tunnel-ip: GRE 터널 연결을 위한 로컬 터널 IP 주소.
--remote-gateway-ip: GRE 터널 연결을 위한 원격 게이트웨이 IP 주소.
--remote-tunnel-ip: GRE 터널 연결을 위한 원격 터널 IP 주소.
--base-connection-id: 선택 사항: GRE 터널의 언더레이 역할을 하는 기존 네트워크 연결의 ID. 이 옵션은 네트워크 유형이 " gre_tunnel "인 경우에만 사용할 수 있습니다.
--base-network-type: 선택 사항: 기본 연결의 네트워크 유형 (classic).
--network-type: 선택 사항: GRE 연결의 네트워크 유형. 값은 gre_tunnel 또는 unbound_gre_tunnel 입니다. 기본값은 gre_tunnel입니다.
--network-account-id: 선택 사항: 클래식 연결에 연결할 계정의 ID. 연결 계정이 게이트웨이 계정과 다른 경우에만 ‘ classic ’ 유형으로만 사용하십시오.
--remote-bgp-asn: 선택 사항: 원격 BGP ASN이 지정되지 않은 경우, ASN이 생성됩니다.
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예제

gre-connection 라는 이름의 GRE 터널 연결을 생성하고, 기본 연결로 클래식 연결 9037f710-8dfb-4948-a2bd-847c8dde96d3 을 사용하도록 설정합니다.

ibmcloud tg connection-gre-create $gateway --name gre-connection --base-connection-id 9037f710-8dfb-9999-a2bd-847c8dde96d3  --zone us-south-2 --local-gateway-ip 192.168.100.1 --local-tunnel-ip 192.168.101.1 --remote-gateway-ip 10.242.63.12 --remote-tunnel-ip 192.168.101.2

`ibmcloud tg connection-reject`

네트워크 소유자로서 다른 계정에서의 연결을 거부합니다.

ibmcloud tg connection-reject|cr GATEWAY_ID CONNECTION_ID [-h, --help]

명령 옵션

GATEWAY_ID: 연결이 이루어진 게이트웨이의 ID.
CONNECTION_ID: 거절하려는 연결의 ID입니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

연결 요청을 거부합니다.

ibmcloud tg cr $gateway $connection

`ibmcloud tg connection-rgre-create`

중계 게이트웨이에서 중복 GRE 연결을 만듭니다.

입력 파일로 JSON 파일을 사용해야 합니다.

ibmcloud tg connection-rgre-create|crgrec --file JSON_FILE_PATH [--output json]

JSON 파일

{
    "gateway_id": "47f11b01-471c-47d0-9e84-550c88c94055",
    "name": "redundant_gre1",
    "network_type": "redundant_gre",
    "base_network_type": "classic",
    "network_account_id": "28e4d90ac7504be694471ee66e70d0d5",
    "network_id": "crn:v1:bluemix:public:is:us-south:a/123456::vpc:4727d842-f94f-4a2d-824a-9bc9b02c523b",
    "tunnels": [
       {
          "local_gateway_ip": "192.168.100.1",
          "local_tunnel_ip": "192.168.129.2",
          "name": "gre1",
          "remote_bgp_asn": 65010,
          "remote_gateway_ip": "10.242.63.12",
          "remote_tunnel_ip": "192.168.129.1",
          "zone": {
             "name": "us-south-1"
          }
       }, {
          "local_gateway_ip": "192.168.101.1",
          "local_tunnel_ip": "192.168.128.2",
          "name": "gre2",
          "remote_bgp_asn": 65010,
          "remote_gateway_ip": "10.242.63.12",
          "remote_tunnel_ip": "192.168.128.1",
          "zone": {
             "name": "us-south-1"
          }
       }
    ]
}

명령 옵션

gateway_id: 새로운 중복 GRE 연결이 설정된 게이트웨이의 ID입니다.
name: 새로운 중복 GRE 연결의 이름입니다.
network_type: 연결의 네트워크 유형. 값은 redundant_gre 입니다.

base_network_type 사용할 네트워크 유형. 옵션은 classic 와 vpc 가 있습니다.

network_account_id: 클래식 네트워크를 통해 계정 간에 사용할 IBM Cloud 계정의 ID입니다. 연결 계정이 게이트웨이 계정과 다른 경우, ‘ classic ’ 유형에서만 사용됩니다. vpc 의 기본 네트워크 유형에는 이 옵션이 적용되지 않습니다.
network_id: 사용할 VPC 네트워크의 CRN입니다. classic 의 기본 네트워크 유형에는 이 옵션이 적용되지 않습니다. 예를 들어, VPC의 CRN을 확인하려면:

ibmcloud is vpc VPC_ID --json

tunnels

GRE 터널에 대한 정보.

local_gateway_ip

GRE 터널 연결을 위한 로컬 게이트웨이 IP 주소. 이 필드는 네트워크 유형 redundant_gre 의 연결에 필요합니다.

vpc 기본 네트워크 유형을 사용하는 경우 이 IP 주소는 RFC 1918을 준수해야 하며 224.0.0.0 ~ 239.255.255.255 의 멀티캐스트 범위 내에 있는 IP 주소가 아니어야 하고 트랜짓 게이트웨이에 연결된 기존 네트워크와 충돌해서는 안 됩니다. 또한 이 IP 주소는 동일한 언더레이 네트워크를 사용하는 다른 GRE의 local-gateway-ip 주소로 사용할 수 없습니다.

local_tunnel_ip

Transit Gateway 에 할당된 로컬 터널 IP 주소입니다. local_tunnel_ip 및 remote_tunnel_ip 주소는 동일한 /30 네트워크에 속해야 합니다. 네트워크도 브로드캐스트 주소도 될 수 없습니다. 이 필드는 네트워크 유형 redundant_gre 의 연결에 필요합니다.

name

GRE 터널의 이름입니다.

remote_bgp_asn

선택 사항: 원격 BGP ASN이 지정되지 않은 경우, ASN이 생성됩니다.

remote_gateway_ip

GRE 터널 연결을 위한 원격 게이트웨이 IP 주소.

remote_tunnel_ip

GRE 터널 연결을 위한 원격 터널 IP 주소.

zone

GRE 터널의 가용성 영역. 예: us-south-1

`ibmcloud tg connection-update`

기존 연결에 대한 특성을 업데이트합니다.

ibmcloud tg connection-update|cu GATEWAY_ID CONNECTION_ID --name NAME [--output json] [-h, --help]

명령 옵션

GATEWAY_ID: 연결이 업데이트되고 있는 게이트웨이의 ID입니다.
CONNECTION_ID: 업데이트할 연결의 ID.
--name: 연결의 새 이름.
--default-prefix-filter: 선택 사항: 연결의 기본 접두사 필터 (permit | deny).
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

연결의 이름을 MyConn2로 업데이트합니다.

ibmcloud tg cu $gateway $connection --name MyConn2

`ibmcloud tg redundant-gre-tunnel-add`

중복 GRE에 터널을 추가합니다.

ibmcloud tg redundant-gre-tunnel-add|targre GATEWAY_ID REDUNDANT_GRE_ID --name NAME --zone ZONE --local-gateway-ip LOCAL_GATEWAY_IP --local-tunnel-ip  LOCAL_TUNNEL_IP --remote-gateway-ip REMOTE_GATEWAY_IP --remote-tunnel-ip REMOTE_TUNNEL_IP [--remote-bgp-asn REMOTE_BGP_ASN] [--output json]

명령 옵션

GATEWAY_ID: 새 연결이 바인딩된 게이트웨이의 ID입니다.
REDUNDANT_GRE_ID: 중복 GRE 연결의 ID.
--name: 새로운 GRE 터널의 이름입니다.
--zone: GRE 터널의 가용성 영역. 예: us-south-1
--local-gateway-ip: GRE 터널 연결을 위한 로컬 게이트웨이 IP 주소.
--local-tunnel-ip: GRE 터널 연결을 위한 로컬 터널 IP 주소.
--remote-gateway-ip: GRE 터널 연결을 위한 원격 게이트웨이 IP 주소.
--remote-tunnel-ip: GRE 터널 연결을 위한 원격 터널 IP 주소.
--remote-bgp-asn: 선택 사항: 원격 BGP ASN이 지정되지 않은 경우, ASN이 생성됩니다.
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

ibmcloud tg redundant-gre-tunnel-add e47d6b9c-095f-4d31-aa47-5c89c2ded820 e4e37e31-8895-4594-be6b-61e8088b53c7 --name gre-tunnel3  --zone us-south-3 --local-gateway-ip 192.193.202.1 --local-tunnel-ip 192.193.237.2 -ibmcloud login -a https://cloud.ibm.com -r us-south --sso -remote-gateway-ip 10.186.203.5 --remote-tunnel-ip 192.193.237.1

`ibmcloud tg redundant-gre-tunnel-remove`

중복 GRE에서 터널을 제거합니다.

ibmcloud tg redundant-gre-tunnel-remove|trrgre GATEWAY_ID REDUNDANT_GRE_ID TUNNEL_ID [--force | -f] [--help | -h]

명령 옵션

GATEWAY_ID: 새 연결이 바인딩된 게이트웨이의 ID입니다.
REDUNDANT_GRE_ID: 중복 GRE 연결의 ID.
TUNNEL_ID: 삭제할 터널의 ID.
--force | -f: 선택 사항: 확인 없이 강제로 삭제합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

ibmcloud tg redundant-gre-tunnel-remove e47d6b9c-095f-4d31-aa47-5c89c2ded820 e4e37e31-8895-4594-be6b-61e8088b53c7 b97a5cf5-7ee4-4073-b719-f6df36dea08f

`ibmcloud tg tunnels`

지정된 중복 GRE 아래에 있는 모든 터널을 나열합니다.

ibmcloud tg tunnels|ts GATEWAY_ID REDUNDANT_GRE_ID [--output json]

명령 옵션

GATEWAY_ID: 새 연결이 바인딩된 게이트웨이의 ID입니다.
REDUNDANT_GRE_ID: 중복 GRE 연결의 ID.
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--force | -f: 선택 사항: 확인 없이 강제로 삭제합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

ibmcloud tg ts e47d6b9c-095f-4d31-aa47-5c89c2ded820 e4e37e31-8895-4594-be6b-61e8088b53c7

위치

이 섹션에서는 위치 관련 기능에 대한 CLI 명령어에 대한 정보를 제공합니다.

`ibmcloud tg locations`

게이트웨이를 작성할 수 있는 위치를 나열하려면 이 명령을 사용하십시오.

ibmcloud tg locations|locs [--output json] [-h, --help]

명령 옵션

--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

`ibmcloud tg location`

이 위치에 대한 특정 정보를 검색합니다.

ibmcloud tg location|loc NAME [--output json] [-h, --help]

명령 옵션

NAME: 자세한 정보를 확인하고자 하는 장소의 이름.
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

us-south 위치에 대한 세부사항을 요청합니다.

ibmcloud tg location us-south

연결 접두사 필터

이 섹션에서는 연결 프리픽스 필터 기능에 대한 CLI 명령어에 대한 정보를 제공합니다.

`ibmcloud tg prefix-filter-create`

연결에 접두부 필터를 추가하십시오.

ibmcloud tg prefix-filter-create GATEWAY_ID CONNECTION_ID --prefix PREFIX --action ACTION [--le LE] [--ge GE] [--before BEFORE] [--output json]

명령 옵션

GATEWAY_ID: 접두사 필터가 적용되는 게이트웨이의 ID입니다.
CONNECTION_ID: 접두사 필터가 적용되는 연결의 ID입니다.
--prefix: 필터가 적용되는 네트워크 접두사입니다.
--action: 지정된 접두사에 대해 수행할 작업 (permit | deny).
--le: 선택 사항: 이 값 이하인 서브넷 마스크에 적용되는 접두사 필터.
--ge: 선택 사항: 이 값 이상인 서브넷 마스크에 적용되는 접두사 필터.
--before: 선택 사항: 이 필터를 적용하기 전에 먼저 적용해야 할 접두사 필터의 식별자. 비어 있는 경우 이 필터가 마지막으로 적용됩니다.
--output: 선택 사항: 출력 형식을 지정합니다. json 만 지원됩니다. 모든 세부 정보가 표시됩니다.

예제

permit 조치로 게이트웨이 9f559c43-63f4-4da5-b312-b525a8dce185, 연결 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7에 대해 10.0.250.0/24의 접두부 필터를 추가하십시오.

ibmcloud tg pfc 9f559c43-63f4-4da5-b312-b525a8dce185 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7 --prefix 10.0.250.0/24 --action permit

`ibmcloud tg prefix-filter-delete`

연결에서 접두부 필터를 삭제합니다.

ibmcloud tg prefix-filter-delete GATEWAY_ID CONNECTION_ID FILTER_ID [-f, --force]

명령 옵션

GATEWAY_ID: 접두사 필터가 삭제된 게이트웨이의 ID입니다.
CONNECTION_ID: 접두사 필터가 삭제된 연결의 ID입니다.
FILTER_ID: 삭제될 접두사 필터의 ID.
--force, -f: 확인 절차 없이 삭제 작업을 강제로 실행합니다.

예제

게이트웨이 9f559c43-63f4-4da5-b312-b525a8dce185 및 연결 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7에서 접두부 필터 ID b4dbe0a6-c52d-4128-cc32-6f53d86bc82b을(를) 삭제합니다.

ibmcloud tg pfd 9f559c43-63f4-4da5-b312-b525a8dce185 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7 b4dbe0a6-c52d-4128-cc32-6f53d86bc82b

라우트 보고서

이 섹션에서는 경로 보고 기능에 대한 CLI 명령어에 대한 정보를 제공합니다.

`ibmcloud tg route-reports`

게이트웨이에서 사용 가능한 라우트 보고서를 나열하려면 이 명령을 사용하십시오.

ibmcloud tg route-reports|rrs GATEWAY_ID [--output json] [-h, --help]

명령 옵션

GATEWAY_ID: 경로 보고서를 열람할 게이트웨이의 ID입니다.
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

게이트웨이에 대한 라우트 보고서를 나열합니다.

ibmcloud tg rrs $gateway

다른 명령은 경로 보고서 ID가 필요합니다. 나중에 사용할 수 있도록 ID를 환경 변수로 저장하세요. 예를 들어:

report="4892849f-368e-9999-4444-8888fb21e513"

`ibmcloud tg route-report`

특정 라우트 보고서에 대한 세부사항을 검색합니다.

ibmcloud tg route-report|rr GATEWAY_ID REPORT_ID [--output json] [-h, --help]

명령 옵션

GATEWAY_ID: 경로 보고서가 전송된 게이트웨이의 ID.
REPORT_ID: 자세한 정보를 확인하려는 경로 보고서의 ID입니다.
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

라우트 보고서에 대한 세부사항을 요청합니다.

ibmcloud tg rr $gateway $report

`ibmcloud tg route-report-create`

라우트 보고서를 작성합니다.

ibmcloud tg route-report-create|rrc GATEWAY_ID [--output json] [-h, --help]

명령 옵션

GATEWAY_ID: 경로 보고서가 생성되는 게이트웨이의 ID입니다.
--output json: 선택 사항: 출력을 JSON 형식으로 표시할지 여부를 지정합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

게이트웨이에 대한 라우트 보고서를 작성합니다.

ibmcloud tg rrc $gateway

`ibmcloud tg route-report-delete`

기존 라우트 보고서를 삭제합니다.

ibmcloud tg route-report-delete|rrd GATEWAY_ID REPORT_ID [-f, --force] [-h, --help]

명령 옵션

GATEWAY_ID: 해당 보고서의 대상 게이트웨이 ID.
REPORT_ID: 삭제하려는 보고서의 ID.
--force | -f: 선택 사항: 확인 없이 강제로 삭제합니다.
--help | -h: 선택 사항: 이 명령에 대한 도움말을 확인하세요.

예

확인하지 않고 라우트 보고서를 삭제합니다.

ibmcloud tg rrd $gateway $report -f

Transit Gateway CLI

Transit Gateway CLI

시작하기 전에

ibmcloud plugin show tg

Transit Gateway

ibmcloud tg gateway

명령 옵션

예

ibmcloud tg gateways

명령 옵션

ibmcloud tg gateway-create

명령 옵션

예

ibmcloud tg gateway-delete

명령 옵션

예

ibmcloud tg gateway-update

명령 옵션

예

연결

ibmcloud tg acc-connections

명령 옵션

예제

ibmcloud tg connection

명령 옵션

예

ibmcloud tg connections

명령 옵션

예

ibmcloud tg connection-create

명령 옵션

예

ibmcloud tg connection-delete

명령 옵션

예

ibmcloud tg connection-create-gre(더 이상 사용되지 않음)

명령 옵션

예제

ibmcloud tg connection-approve

명령 옵션

예

ibmcloud tg connection-gre-create

명령 옵션

예제

ibmcloud tg connection-reject

명령 옵션

예

ibmcloud tg connection-rgre-create

JSON 파일

명령 옵션

ibmcloud tg connection-update

명령 옵션

예

ibmcloud tg redundant-gre-tunnel-add

명령 옵션

예

ibmcloud tg redundant-gre-tunnel-remove

명령 옵션

예

ibmcloud tg tunnels

명령 옵션

예

위치

ibmcloud tg locations

명령 옵션

ibmcloud tg location

명령 옵션

예

연결 접두사 필터

ibmcloud tg prefix-filter-create

명령 옵션

예제

ibmcloud tg prefix-filter-delete

명령 옵션

예제

라우트 보고서

ibmcloud tg route-reports

명령 옵션

예

ibmcloud tg route-report

`ibmcloud plugin show tg`

`ibmcloud tg gateway`

`ibmcloud tg gateways`

`ibmcloud tg gateway-create`

`ibmcloud tg gateway-delete`

`ibmcloud tg gateway-update`

`ibmcloud tg acc-connections`

`ibmcloud tg connection`

`ibmcloud tg connections`

`ibmcloud tg connection-create`

`ibmcloud tg connection-delete`

`ibmcloud tg connection-create-gre`(더 이상 사용되지 않음)

`ibmcloud tg connection-approve`

`ibmcloud tg connection-gre-create`

`ibmcloud tg connection-reject`

`ibmcloud tg connection-rgre-create`

`ibmcloud tg connection-update`

`ibmcloud tg redundant-gre-tunnel-add`

`ibmcloud tg redundant-gre-tunnel-remove`

`ibmcloud tg tunnels`

`ibmcloud tg locations`

`ibmcloud tg location`

`ibmcloud tg prefix-filter-create`

`ibmcloud tg prefix-filter-delete`

`ibmcloud tg route-reports`

`ibmcloud tg route-report`

`ibmcloud tg route-report-create`

`ibmcloud tg route-report-delete`