Dual-Stack Endpoints and Support for IPv6

• Environment variable: set OCI_DUAL_STACK_ENDPOINT_ENABLED=true in the session.
• Client setting: set client_level_dualstack_endpoints_enabled = True and client_level_realm_specific_endpoint_template_enabled = True to direct Object Storage requests to the dual-stack endpoint for the region.

import os
import oci

config = oci.config.from_file()
compartment_id = config["tenancy"]
os.environ["OCI_DUAL_STACK_ENDPOINT_ENABLED"] = "True"
object_storage = oci.object_storage.ObjectStorageClient(config,
                                                        client_level_dualstack_endpoints_enabled=True,
                                                        client_level_realm_specific_endpoint_template_enabled=True)
print("endpoint: ", object_storage.base_client.endpoint)
namespace = object_storage.get_namespace().data
print("namespace: ", namespace)

• Client setting: set enableDualStackEndpoints(true) and useRealmSpecificEndpointTemplate(true) to direct Object Storage requests to the dual-stack endpoint for the region. Example:

public class EnableDualStackEndpointsExample {
    public static void main(String[] args) throws Exception {
        String configurationFilePath = "~/.oci/config";
        String profile = "DEFAULT";
        // Configuring the AuthenticationDetailsProvider. It's assuming there is a default OCI
        // config file
        // "~/.oci/config", and a profile in that config with the name "DEFAULT". Make changes to
        // the following
        // line if needed and use ConfigFileReader.parse(configurationFilePath, profile);
        final ConfigFileReader.ConfigFile configFile = ConfigFileReader.parseDefault();
        final AuthenticationDetailsProvider provider =
                new ConfigFileAuthenticationDetailsProvider(configFile);
        ObjectStorage client = ObjectStorageClient.builder().build(provider);
        // this is set per client. Once set, the dual stack will be enabled for all the API
        // endpoints for this client
        client.enableDualStackEndpoints(true);
        client.useRealmSpecificEndpointTemplate(true);
        System.out.println(client.getEndpoint());
        GetNamespaceResponse namespaceResponse =
                client.getNamespace(GetNamespaceRequest.builder().build());
        String namespaceName = namespaceResponse.getValue();
        System.out.println("Using namespace: " + namespaceName);
        ListBucketsRequest.Builder listBucketsBuilder =
                ListBucketsRequest.builder()
                        .namespaceName(namespaceName)
                        .compartmentId(provider.getTenantId());

        String nextToken = null;
        do {
            listBucketsBuilder.page(nextToken);
            ListBucketsResponse listBucketsResponse =
                    client.listBuckets(listBucketsBuilder.build());
            for (BucketSummary bucket : listBucketsResponse.getItems()) {
                System.out.println("Found bucket: " + bucket.getName());
            }
            nextToken = listBucketsResponse.getOpcNextPage();
        } while (nextToken != null);
        client.close();
        IdentityClient identityClient = IdentityClient.builder().build(provider);
        GetAuthenticationPolicyResponse getAuthenticationPolicyResponse =
                identityClient.getAuthenticationPolicy(
                        GetAuthenticationPolicyRequest.builder()
                                // currently only the tenant (ie the root compartment) can have an
                                // authentication policy
                                .compartmentId(provider.getTenantId())
                                .build());
        System.out.printf(
                "The Authentication Policy is: %s\n",
                getAuthenticationPolicyResponse.getAuthenticationPolicy().toString());
        identityClient.close();
    }
}

• Environment variable: set OCI_DUAL_STACK_ENDPOINT_ENABLED=true and OCI_REALM_SPECIFIC_SERVICE_ENDPOINT_TEMPLATE_ENABLED=true in the session.
• Client setting: call EnableDualStackEndpoints(true) and RealmSpecificServiceEndpointTemplateEnabled: common.Bool(true)to direct Object Storage requests to the dual-stack endpoint for the region. Example:

// This example shows how to set the environment variable OCI_DUAL_STACK_ENDPOINT_ENABLED
	// to enable dual stack endpoints.
	os.Setenv("OCI_DUAL_STACK_ENDPOINT_ENABLED", "true")

// Dual stack endpoints can be enabled at the client level as shown, or through the
	// environment variable OCI_DUAL_STACK_ENDPOINT_ENABLED
	c.EnableDualStackEndpoints(true)

// This example shows how to use realm specific endpoint to get object.
	// You can select either this environment variable or the customClientConfiguration to enable realm specific endpoint.
	os.Setenv("OCI_REALM_SPECIFIC_SERVICE_ENDPOINT_TEMPLATE_ENABLED", "true")

// An alternative way to enable realm specific endpoint is to use the following code.
	c.SetCustomClientConfiguration(common.CustomClientConfiguration{
		RealmSpecificServiceEndpointTemplateEnabled: common.Bool(true),
	})

curl -v -6 https://MyNamespace.objectstorage.us-ashburn-1.ds.oci.customer-oci.com/v2:healthcheck

• If you're configured to access IPv6, the connected IP address shows as an IPv6 address.
• If you aren't configured to access IPv6, output can stop after Trying IPv6 Address... with no further information.

• If you're configured to access IPv6, the connected IP address shows as an IPv6 address.
• If you aren't configured to access IPv6, output can stop after Trying IPv6 Address... with no further information.