Listing Object Storage Private Endpoints

View a list of the Object Storage private endpoints in a Oracle Cloud Infrastructure compartment.

1. Open the navigation menu and select Storage. Under Object Storage & Archive Storage, select Private Endpoints.
  The Private endpoints list page opens. All existing Object Storage private endpoint resources in the selected compartment are displayed in a list table.
2. To view the resources in a different compartment, use the Compartment filter to switch compartments.
  
  You must have permission to work in a compartment to see the resources in it. If you're not sure which compartment to use, contact an administrator. For more information, see Understanding Compartments.
Filtering List Results
Use filters to limit the Object Storage replication policy in the list. Perform one of the following actions depending on the options that you see:
From the Search and Filter box above the list table, select one or more filters and specify the values that you want to use to narrow the list. In general, the filters correspond to the columns shown in the list table, although some filters represent attributes that aren't shown in the table. The Compartment filter is always displayed next to Applied filters.

On the left side of the list page, select a value from one of the available filters, such as compartment, state, or tags.

Change the order of the items in the list table by using the sort icons next to the column names.

For information about searching for resources and managing the columns in the list table, if those features are available, see Listing Resources.
Actions
In the list table, select the name of a private endpoint to open its details page, where you can view its status and perform other tasks.

To perform an action on a bucket directly from the list table, select any of the following options from the Actions menu in the row for that private endpoint:
- View details: Open details on the private endpoint.
- Copy v2 fqdn: Copy the fully qualified domain name prefix for the Object Storage API.
- Copy swift fqdn: Copy the fully qualified domain name prefix for the AWS S3 Compatibility API.
- Copy s3 fqdn: Copy the fully qualified domain name prefix for the Swift API.
- Edit endpoint: Update the private endpoint's settings.
- Delete endpoint: Delete the private endpoint.
To create a private endpoint, select Create private endpoint.

Use the oci os private-endpoint list command and required parameters to list the private endpoints in a compartment in Object Storage:

oci os private-endpoint list --compartment-id compartment_ocid [OPTIONS]

For example:

oci os private-endpoint list --compartment-id ocid1.tenancy.oc1..exampleuniqueID
                
{
  "data": [
    {
      "compartment-id": "ocid1.tenancy.oc1..exampleuniqueID",
      "created-by": "ocid1.user.region1..exampleuniqueID",
      "etag": "d8021157-3221-489d-ab8a-9e3fb36cdce4",
      "fqdns": {
        "additional-prefixes-fqdns": {},
        "prefix-fqdns": {
          "object-storage-api-fqdn": "pe1-MyNamespace.private.objectstorage.us-phoenix-1.oci.customer-oci.com",
          "s3-compatibility-api-fqdn": "pe1-MyNamespace.private.compat.objectstorage.us-phoenix-1.oci.customer-oci.com",
          "swift-api-fqdn": "pe1-MyNamespace.private.swiftobjectstorage.us-phoenix-1.oci.customer-oci.com"
        }
      },
      "lifecycle-state": "ACTIVE",
      "name": "pe1",
      "namespace": "MyNamespace",
      "prefix": "pe1",
      "time-created": "2024-06-20T06:33:56.866000+00:00",
      "time-modified": null
    },
    {
      "compartment-id": "ocid1.tenancy.oc1..exampleuniqueID",
      "created-by": "ocid1.user.region1..exampleuniqueID",
      "etag": "41958c18-7172-416c-8c22-7c3107c76cc0",
      "fqdns": {
        "additional-prefixes-fqdns": {},
        "prefix-fqdns": {
          "object-storage-api-fqdn": "pe2-MyNamespace.private.objectstorage.us-phoenix-1.oci.customer-oci.com",
          "s3-compatibility-api-fqdn": "pe2-MyNamespace.private.compat.objectstorage.us-phoenix-1.oci.customer-oci.com",
          "swift-api-fqdn": "pe2-MyNamespace.private.swiftobjectstorage.us-phoenix-1.oci.customer-oci.com"
        }
      },
      "lifecycle-state": "ACTIVE",
      "name": "pe2",
      "namespace": "MyNamespace",
      "prefix": "pe2",
      "time-created": "2024-06-20T06:40:42.865000+00:00",
      "time-modified": null
    }
  ]
}

For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

Run the following API operation:
```
GET n/object_storage_namespace/pe/
```

Oracle Cloud Infrastructure Documentation

Listing Object Storage Private Endpoints

Filtering List Results

Actions