Jump to

• Request
• Response

List Services

get

/20160918/services

List the available Service objects that you can enable for a service gateway.

Request

Supported Media Types

• application/json

Query Parameters

• limit: integer
  Minimum Value: 1

  Maximum Value: 1000

  For list pagination. The maximum number of results per page, or items to return in a paginated List call. 1 is the minimum, 1000 is the maximum.

  Default Value: 100
• page: string
  Minimum Length: 1

  Maximum Length: 512

  For list pagination. The value of the opc-next-page response header from the previous List call.

  Default Value: 0

Back to Top

Response

Supported Media Types

• application/json

200 Response

The list is being retrieved.

Headers

• opc-next-page: string
  For list pagination. When this header appears in the response, additional pages of results remain. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
• opc-request-id: string
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: object Service
  An object that represents one or multiple Oracle services that you can enable for a ServiceGateway. The service CIDR label is to the string that represents the regional public IP address ranges of the Oracle service or services covered by a given Service object. That unique string is the value of the Service object's cidrBlock attribute.

{
    "items":{
        "$ref":"#/definitions/Service"
    },
    "type":"array"
}

Nested Schema : Service

Type: object

An object that represents one or multiple Oracle services that you can enable for a ServiceGateway. The service CIDR label is to the string that represents the regional public IP address ranges of the Oracle service or services covered by a given Service object. That unique string is the value of the Service object's cidrBlock attribute.

Show Source

• cidrBlock(required): string
  Minimum Length: 1

  Maximum Length: 255

  A string that represents the regional public IP address ranges for the Oracle service or services covered by this Service object. Also known as the Service object's service CIDR label. When you set up a route rule to route traffic to the service gateway, use this value as the rule's destination. Also, when you set up a security list rule to cover traffic with the service gateway, use the cidrBlock value as the rule's destination (for an egress rule) or the source (for an ingress rule). Example: oci-phx-objectstorage
• description(required): string
  Minimum Length: 1

  Maximum Length: 255

  Description of the Oracle service or services covered by this Service object. Example: OCI PHX Object Storage
• id(required): string
  Minimum Length: 1

  Maximum Length: 255

  The Service object's OCID.
• name(required): string
  Minimum Length: 1

  Maximum Length: 127

  Name of the Service object. This name can change and is not guaranteed to be unique. Example: OCI PHX Object Storage

{
    "description":"An object that represents one or multiple Oracle services that you can enable for a ServiceGateway. The service CIDR label is to the string that represents the regional public IP address ranges of the Oracle service or services covered by a given Service object. That unique string is the value of the Service object's cidrBlock attribute.",
    "properties":{
        "cidrBlock":{
            "description":"A string that represents the regional public IP address ranges for the Oracle service or services covered by this Service object. Also known as the Service object's service CIDR label. When you set up a route rule to route traffic to the service gateway, use this value as the rule's destination. Also, when you set up a security list rule to cover traffic with the service gateway, use the cidrBlock value as the rule's destination (for an egress rule) or the source (for an ingress rule). Example: oci-phx-objectstorage ",
            "maxLength":255,
            "minLength":1,
            "type":"string"
        },
        "description":{
            "description":"Description of the Oracle service or services covered by this Service object. Example: OCI PHX Object Storage ",
            "maxLength":255,
            "minLength":1,
            "type":"string"
        },
        "id":{
            "description":"The Service object's OCID.",
            "maxLength":255,
            "minLength":1,
            "type":"string"
        },
        "name":{
            "description":"Name of the Service object. This name can change and is not guaranteed to be unique. Example: OCI PHX Object Storage ",
            "maxLength":127,
            "minLength":1,
            "type":"string"
        }
    },
    "required":[
        "id",
        "name",
        "cidrBlock",
        "description"
    ],
    "type":"object"
}

500 Response

Internal Server Error

Headers

• opc-request-id: string
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

The properties that define an error.

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
• message(required): string
  A human-readable error string.

{
    "description":"The properties that define an error.",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm)."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "type":"object"
}

Default Response

An error has occurred.

Headers

• opc-request-id: string
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

The properties that define an error.

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
• message(required): string
  A human-readable error string.

{
    "description":"The properties that define an error.",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm)."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "type":"object"
}

Back to Top