CreateRouteTable

post

/20160918/routeTables

Create a new route table for the specified VCN. Include at least one route rule for the new route table.

Provide the OCID of the compartment where you want the route table to reside. The route table does not need to be in the same compartment as the VCN, subnets, or other Networking Service components. If you are not sure which compartment to use, put the route table in the same compartment as the VCN.

You may optionally specify a display name for the route table. If you do not, a default display name is provided. The display name does not need to be unique, and you can change it. Avoid entering confidential information.

Request

Supported Media Types
Header Parameters
  • Minimum Length: 1
    Maximum Length: 64
    A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
Body ()
Details for creating a new route table.
Root Schema : CreateRouteTableDetails
Type: object
Show Source
Nested Schema : definedTags
Type: object
Additional Properties Allowed
Show Source
Defined tags for this resource. Each key is predefined and scoped to a namespace.
Nested Schema : freeformTags
Type: object
Additional Properties Allowed
Show Source
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. Example: {"Department": "Finance"}
Nested Schema : routeRules
Type: array
The collection of rules used for routing destination IPs to network devices.
Show Source
  • RouteRule
    A mapping between a destination IP address range and a virtual device to route matching packets to (a target).
Nested Schema : additionalProperties
Type: object
Additional Properties Allowed
Show Source
Key-value pair representing a defined tag key and value, scoped to a namespace.
Nested Schema : additionalProperties
Type: object
The value of the tag. Only the String type is supported.
Nested Schema : RouteRule
Type: object
A mapping between a destination IP address range and a virtual device to route matching packets to (a target).
Show Source
  • Minimum Length: 9
    Maximum Length: 18
    Deprecated. Instead use destination and destinationType. Requests that include both cidrBlock and destination will be rejected. A destination IP address range in CIDR notation. Matching packets will be routed to the indicated network entity (the target). Cannot be an IPv6 CIDR. Example: 0.0.0.0/0
  • Minimum Length: 1
    Maximum Length: 255
    An optional description of your choice for the rule.
  • Minimum Length: 1
    Maximum Length: 255
    This is the range of IP addresses used for matching when routing traffic. This value is required if you provide a destinationType. The following values are allowed:
  • IP address range in CIDR notation. Can be an IPv4 or IPv6 CIDR. For example: 192.168.1.0/24 or 2001:0db8:0123:45::/56. If you set this to an IPv6 CIDR, the route rule's target can only be a DRG or internet gateway.
  • The cidrBlock value for a Service, if you're setting up a route rule for traffic destined for a particular Service through a service gateway.
  • Default Value: CIDR_BLOCK
    Allowed Values: [ "CIDR_BLOCK", "SERVICE_CIDR_BLOCK" ]
    Type of destination for the rule. This value is required if you provide a destination. The following values are allowed:
  • CIDR_BLOCK: If the rule's destination is an IP address range in CIDR notation.
  • SERVICE_CIDR_BLOCK: If the rule's destination is the cidrBlock value for a Service (the rule is for traffic destined for a particular Service through a service gateway).
  • Minimum Length: 1
    Maximum Length: 255
    The OCID for the route rule's target.
  • Allowed Values: [ "STATIC", "LOCAL" ]
    A route rule can be STATIC if manually added to the Route Table, LOCAL if added by OCI to the Route Table.
  • Back to Top

    Response

    Supported Media Types

    200 Response

    The route table was created.
    Headers
    • For optimistic concurrency control. See if-match.
    • Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
    Body ()
    Root Schema : RouteTable
    Type: object
    A collection of RouteRule objects, which are used to route packets based on destination IP to a particular network entity.
    Show Source
    Nested Schema : definedTags
    Type: object
    Additional Properties Allowed
    Show Source
    Defined tags for this resource. Each key is predefined and scoped to a namespace.
    Nested Schema : freeformTags
    Type: object
    Additional Properties Allowed
    Show Source
    Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. Example: {"Department": "Finance"}
    Nested Schema : routeRules
    Type: array
    The collection of rules for routing destination IPs to network devices.
    Show Source
    • RouteRule
      A mapping between a destination IP address range and a virtual device to route matching packets to (a target).
    Nested Schema : additionalProperties
    Type: object
    Additional Properties Allowed
    Show Source
    Key-value pair representing a defined tag key and value, scoped to a namespace.
    Nested Schema : additionalProperties
    Type: object
    The value of the tag. Only the String type is supported.
    Nested Schema : RouteRule
    Type: object
    A mapping between a destination IP address range and a virtual device to route matching packets to (a target).
    Show Source
    • Minimum Length: 9
      Maximum Length: 18
      Deprecated. Instead use destination and destinationType. Requests that include both cidrBlock and destination will be rejected. A destination IP address range in CIDR notation. Matching packets will be routed to the indicated network entity (the target). Cannot be an IPv6 CIDR. Example: 0.0.0.0/0
    • Minimum Length: 1
      Maximum Length: 255
      An optional description of your choice for the rule.
    • Minimum Length: 1
      Maximum Length: 255
      This is the range of IP addresses used for matching when routing traffic. This value is required if you provide a destinationType. The following values are allowed:
    • IP address range in CIDR notation. Can be an IPv4 or IPv6 CIDR. For example: 192.168.1.0/24 or 2001:0db8:0123:45::/56. If you set this to an IPv6 CIDR, the route rule's target can only be a DRG or internet gateway.
    • The cidrBlock value for a Service, if you're setting up a route rule for traffic destined for a particular Service through a service gateway.
  • Default Value: CIDR_BLOCK
    Allowed Values: [ "CIDR_BLOCK", "SERVICE_CIDR_BLOCK" ]
    Type of destination for the rule. This value is required if you provide a destination. The following values are allowed:
  • CIDR_BLOCK: If the rule's destination is an IP address range in CIDR notation.
  • SERVICE_CIDR_BLOCK: If the rule's destination is the cidrBlock value for a Service (the rule is for traffic destined for a particular Service through a service gateway).
  • Minimum Length: 1
    Maximum Length: 255
    The OCID for the route rule's target.
  • Allowed Values: [ "STATIC", "LOCAL" ]
    A route rule can be STATIC if manually added to the Route Table, LOCAL if added by OCI to the Route Table.
  • 400 Response

    Bad Request
    Headers
    • Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
    Body ()
    Root Schema : Error
    Type: object
    The properties that define an error.
    Show Source

    401 Response

    Unauthorized
    Headers
    • Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
    Body ()
    Root Schema : Error
    Type: object
    The properties that define an error.
    Show Source

    404 Response

    Not Found
    Headers
    • Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
    Body ()
    Root Schema : Error
    Type: object
    The properties that define an error.
    Show Source

    409 Response

    Conflict
    Headers
    • Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
    Body ()
    Root Schema : Error
    Type: object
    The properties that define an error.
    Show Source

    500 Response

    Internal Server Error
    Headers
    • Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
    Body ()
    Root Schema : Error
    Type: object
    The properties that define an error.
    Show Source

    Default Response

    An error has occurred.
    Headers
    • Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
    Body ()
    Root Schema : Error
    Type: object
    The properties that define an error.
    Show Source
    Back to Top