create

Create a NAT Gateway Rule

Usage

ionosctl natgateway rule create [flags]

Aliases

For natgateway command:

[nat ng]

For rule command:

[r]

For create command:

[c]

Description

Use this command to create a NAT Gateway Rule in a specified NAT Gateway.

You can wait for the Request to be executed using --wait-for-request option.

Required values to run command:

• Data Center Id

• NAT Gateway Id

• Public IP

• Source Subnet

Options

  -u, --api-url string         Override default host URL. Preferred over the config file override 'cloud' and env var 'IONOS_API_URL' (default "https://api.ionos.com")
      --cols strings           Set of columns to be printed on output 
                               Available columns: [NatGatewayRuleId Name Type Protocol SourceSubnet PublicIp TargetSubnet TargetPortRangeStart TargetPortRangeEnd State] (default [NatGatewayRuleId,Name,Protocol,SourceSubnet,PublicIp,TargetSubnet,State])
  -c, --config string          Configuration file used for authentication (default "$XDG_CONFIG_HOME/ionosctl/config.yaml")
      --datacenter-id string   The unique Data Center Id (required)
  -D, --depth int32            Controls the detail depth of the response objects. Max depth is 10.
  -f, --force                  Force command to execute without user input
  -h, --help                   Print usage
      --ip ip                  Public IP address of the NAT Gateway Rule (required)
      --limit int              Pagination limit: Maximum number of items to return per request (default 50)
  -n, --name string            Name of the NAT Gateway Rule (default "Unnamed Rule")
      --natgateway-id string   The unique NatGateway Id (required)
      --no-headers             Don't print table headers when table output is used
      --offset int             Pagination offset: Number of items to skip before starting to collect the results
  -o, --output string          Desired output format [text|json|api-json] (default "text")
      --port-range-end int     Target port range end associated with the NAT Gateway Rule (default 1)
      --port-range-start int   Target port range start associated with the NAT Gateway Rule (default 1)
  -p, --protocol string        Protocol of the NAT Gateway Rule. If protocol is 'ICMP' then targetPortRange start and end cannot be set (required) (default "ALL")
      --query string           JMESPath query string to filter the output
  -q, --quiet                  Quiet output
      --source-subnet string   Source subnet of the NAT Gateway Rule (required)
      --target-subnet string   Target subnet or destination subnet of the NAT Gateway Rule
  -t, --timeout int            Timeout option for Request for NAT Gateway Rule creation [seconds] (default 60)
  -v, --verbose count          Increase verbosity level [-v, -vv, -vvv]
  -w, --wait-for-request       Wait for the Request for NAT Gateway Rule creation to be executed

Examples

ionosctl natgateway rule create --datacenter-id DATACENTER_ID --natgateway-id NATGATEWAY_ID --name NAME --ip IP_1 --source-subnet SOURCE_SUBNET --target-subnet TARGET_SUBNET