Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)



Forwarding Rule Commands

Contents

addforwardingrule

addforwardingrule            Create a new forwarding rule to handle network load
                             balancing.

                             Usage: gcutil [--global_flags] addforwardingrule
                             [--command_flags] <forwarding-rule-name>

                             Flags for addforwardingrule:

gcutil_lib.forwarding_rule_cmds:
  --description: An optional forwarding rule description.
    (default: '')
  --ip: Specifies the IP address for which this forwarding rule applies. The
    default value is 'ephemeral' which indicates that the service should use any
    available ephemeral IP address. If you want to explicitly use a certain IP,
    the IP must be reserved by the project and not in use by another resource.
    (default: '')
  --port_range: Specifies the port range of packets that will be forwarded to
    the target pool. Only packets addressed to ports in this range will be
    forwarded. Can be a single port (e.g. '--port_range=80') or a single range
    (e.g '--port=8000-9000'). If no ports are specified, the forwarding rule
    sends all traffic from ports for the specified protocol, to the specified
    target pool.
    (default: '')
  --protocol: Specifies the IP protocol for which this rule applies. Valid
    values are 'TCP' and 'UDP'. The default value is 'TCP'.
    (default: 'TCP')
  --region: [Required] The region for this request.
  --target: [Required] Specifies the name of the TargetPool resource to handle
    rule-matched network traffic. The target pool must exist before you can use
    it for a forwarding rule. You can only specify one target pool per
    forwarding rule.
  --target_instance: Specifies the name of the TargetInstance resource to handle
    rule-matched network traffic. The target instance must exist before you can
    use it for a forwarding rule. You must specify only one of --target_pool or
    --target_instance.
  --target_pool: Specifies the name of the TargetPool resource to handle
    rule-matched network traffic. The target pool must exist before you can use
    it for a forwarding rule. You must specify only one of --target_pool or
    --target_instance.

gflags:
  --flagfile: Insert flag definitions from the given file into the command line.
    (default: '')
  --undefok: comma-separated list of flag names that it is okay to specify on
    the command line even if the program does not define a flag with that name.
    IMPORTANT: flags in this list that have arguments MUST use the --flag=value
    format.
    (default: '')

deleteforwardingrule

deleteforwardingrule         Delete one or more forwarding rule.

                             Specify multiple forwarding rules as multiple
                             arguments. The forwarding rules will be deleted in
                             parallel.

                             Usage: gcutil [--global_flags] deleteforwardingrule
                             [--command_flags] <forwarding-rule-name-1> ...
                             <forwarding-rule-name-n>

                             Flags for deleteforwardingrule:

gcutil_lib.command_base:
  -f,--[no]force: Override the "Delete forwarding rule" prompt
    (default: 'false')

gcutil_lib.forwarding_rule_cmds:
  --region: [Required] The region for this request.

gflags:
  --flagfile: Insert flag definitions from the given file into the command line.
    (default: '')
  --undefok: comma-separated list of flag names that it is okay to specify on
    the command line even if the program does not define a flag with that name.
    IMPORTANT: flags in this list that have arguments MUST use the --flag=value
    format.
    (default: '')

getforwardingrule

getforwardingrule            Get a forwarding rule.

                             Usage: gcutil [--global_flags] getforwardingrule
                             [--command_flags] <forwarding-rule-name>

                             Flags for getforwardingrule:

gcutil_lib.forwarding_rule_cmds:
  --region: [Required] The region for this request.

gflags:
  --flagfile: Insert flag definitions from the given file into the command line.
    (default: '')
  --undefok: comma-separated list of flag names that it is okay to specify on
    the command line even if the program does not define a flag with that name.
    IMPORTANT: flags in this list that have arguments MUST use the --flag=value
    format.
    (default: '')

listforwardingrules

listforwardingrules          List the forwarding rule for a project.

                             Usage: gcutil [--global_flags] listforwardingrules
                             [--command_flags]

                             Flags for listforwardingrules:

gcutil_lib.command_base:
  --columns: A comma-separated list of the desired columns to display. If 'all'
    is specified, then all possible columns will be included. Valid columns are
    <all|name|description|region|ip|protocol|port-range|target>.
    (a comma separated list)
  --[no]fetch_all_pages: Deprecated flag.
    (default: 'true')
  --filter: Filter expression for filtering listed resources. See gcutil
    documentation for syntax of the filter expression here:
    http://developers.google.com/compute/docs/gcutil/tips#filtering
  --max_results: Maximum number of items to list [Default is to fetch all].
    (a positive integer)

gcutil_lib.forwarding_rule_cmds:
  --region: [Required] The region for this request.

gcutil_lib.gcutil_flags:
  --sort_by: <name|-name|region|-region|ip|-ip>: Sort output results by the
    given field name. Field names starting with a "-" will lead to a descending
    order.

gflags:
  --flagfile: Insert flag definitions from the given file into the command line.
    (default: '')
  --undefok: comma-separated list of flag names that it is okay to specify on
    the command line even if the program does not define a flag with that name.
    IMPORTANT: flags in this list that have arguments MUST use the --flag=value
    format.
    (default: '')

setforwardingruletarget

setforwardingruletarget      Set the target of an existing forwarding rule.

                             Usage: gcutil [--global_flags]
                             setforwardingruletarget [--command_flags]
                             <forwarding-rule-name>

                             Flags for setforwardingruletarget:

gcutil_lib.forwarding_rule_cmds:
  --region: [Required] The region for this request.
  --target: [Required] Specifies the name of the TargetPool resource to handle
    rule-matched network traffic. The target pool must exist before you can use
    it for a forwarding rule. You can only specify one target pool per
    forwarding rule.
  --target_instance: Specifies the name of the TargetInstance resource to handle
    rule-matched network traffic. The target instance must exist before you can
    use it for a forwarding rule. You must specify only one of --target_pool or
    --target_instance.
  --target_pool: Specifies the name of the TargetPool resource to handle
    rule-matched network traffic. The target pool must exist before you can use
    it for a forwarding rule. You must specify only one of --target_pool or
    --target_instance.

gflags:
  --flagfile: Insert flag definitions from the given file into the command line.
    (default: '')
  --undefok: comma-separated list of flag names that it is okay to specify on
    the command line even if the program does not define a flag with that name.
    IMPORTANT: flags in this list that have arguments MUST use the --flag=value
    format.
    (default: '')

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.