GO SDK 5.2.0 Release

GO SDK 5.2.0 Release

Author: dshelbyo

CHANGELOG.md

@@ -4,6 +4,11 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 
+## 5.2.0 - 2019-04-02
+### Added
+- Support for provider service key names on virtual circuits in the FastConnect service
+- Support for customer reference names on cross connects and cross connect groups in the FastConnect service
+
 ## 5.1.0 - 2019-03-26
 ### Added
 - Support for glob patterns and exclusions for object lifecycle management in the Object Storage service

common/version.go

@@ -31,7 +31,7 @@ type AttachParavirtualizedVolumeDetails struct {
 	// Whether the attachment was created in read-only mode.
 	IsReadOnly *bool `mandatory:"false" json:"isReadOnly"`
 
-	// Whether to enable encryption in transit for the PV data volume attachment. Defaults to false.
+	// Whether to enable in-transit encryption for the data volume's paravirtualized attachment. The default value is false.
 	IsPvEncryptionInTransitEnabled *bool `mandatory:"false" json:"isPvEncryptionInTransitEnabled"`
 }
 

core/attach_paravirtualized_volume_details.go

@@ -45,7 +45,7 @@ type BootVolumeAttachment struct {
 	// Example: `My boot volume`
 	DisplayName *string `mandatory:"false" json:"displayName"`
 
-	// Whether the enable encryption in transit for the PV volume attachment is on or not.
+	// Whether in-transit encryption for the boot volume's paravirtualized attachment is enabled or not.
 	IsPvEncryptionInTransitEnabled *bool `mandatory:"false" json:"isPvEncryptionInTransitEnabled"`
 }
 

core/boot_volume_attachment.go

@@ -319,7 +319,7 @@ func (client ComputeClient) createAppCatalogSubscription(ctx context.Context, re
 // use ImageSourceViaObjectStorageTupleDetails.
 // When importing an image based on the Object Storage URL, use
 // ImageSourceViaObjectStorageUriDetails.
-// See Object Storage URLs (https://docs.cloud.oracle.com/Content/Compute/Tasks/imageimportexport.htm#URLs) and pre-authenticated requests (https://docs.cloud.oracle.com/Content/Object/Tasks/managingaccess.htm#pre-auth)
+// See Object Storage URLs (https://docs.cloud.oracle.com/Content/Compute/Tasks/imageimportexport.htm#URLs) and Using Pre-Authenticated Requests (https://docs.cloud.oracle.com/Content/Object/Tasks/usingpreauthenticatedrequests.htm)
 // for constructing URLs for image import/export.
 // For more information about importing exported images, see
 // Image Import/Export (https://docs.cloud.oracle.com/Content/Compute/Tasks/imageimportexport.htm).
@@ -733,7 +733,7 @@ func (client ComputeClient) detachVolume(ctx context.Context, request common.OCI
 // For more information about exporting images, see Image Import/Export (https://docs.cloud.oracle.com/Content/Compute/Tasks/imageimportexport.htm).
 // To perform an image export, you need write access to the Object Storage bucket for the image,
 // see Let Users Write Objects to Object Storage Buckets (https://docs.cloud.oracle.com/Content/Identity/Concepts/commonpolicies.htm#Let4).
-// See Object Storage URLs (https://docs.cloud.oracle.com/Content/Compute/Tasks/imageimportexport.htm#URLs) and pre-authenticated requests (https://docs.cloud.oracle.com/Content/Object/Tasks/managingaccess.htm#pre-auth)
+// See Object Storage URLs (https://docs.cloud.oracle.com/Content/Compute/Tasks/imageimportexport.htm#URLs) and Using Pre-Authenticated Requests (https://docs.cloud.oracle.com/Content/Object/Tasks/usingpreauthenticatedrequests.htm)
 // for constructing URLs for image import/export.
 func (client ComputeClient) ExportImage(ctx context.Context, request ExportImageRequest) (response ExportImageResponse, err error) {
 	var ociResponse common.OCIResponse

core/core_compute_client.go

@@ -2666,6 +2666,48 @@ func (client VirtualNetworkClient) getFastConnectProviderService(ctx context.Con
 	return response, err
 }
 
+// GetFastConnectProviderServiceKey Gets the specified provider service key's information.
+func (client VirtualNetworkClient) GetFastConnectProviderServiceKey(ctx context.Context, request GetFastConnectProviderServiceKeyRequest) (response GetFastConnectProviderServiceKeyResponse, err error) {
+	var ociResponse common.OCIResponse
+	policy := common.NoRetryPolicy()
+	if request.RetryPolicy() != nil {
+		policy = *request.RetryPolicy()
+	}
+	ociResponse, err = common.Retry(ctx, request, client.getFastConnectProviderServiceKey, policy)
+	if err != nil {
+		if ociResponse != nil {
+			response = GetFastConnectProviderServiceKeyResponse{RawResponse: ociResponse.HTTPResponse()}
+		}
+		return
+	}
+	if convertedResponse, ok := ociResponse.(GetFastConnectProviderServiceKeyResponse); ok {
+		response = convertedResponse
+	} else {
+		err = fmt.Errorf("failed to convert OCIResponse into GetFastConnectProviderServiceKeyResponse")
+	}
+	return
+}
+
+// getFastConnectProviderServiceKey implements the OCIOperation interface (enables retrying operations)
+func (client VirtualNetworkClient) getFastConnectProviderServiceKey(ctx context.Context, request common.OCIRequest) (common.OCIResponse, error) {
+	httpRequest, err := request.HTTPRequest(http.MethodGet, "/fastConnectProviderServices/{providerServiceId}/providerServiceKeys/{providerServiceKeyName}")
+	if err != nil {
+		return nil, err
+	}
+
+	var response GetFastConnectProviderServiceKeyResponse
+	var httpResponse *http.Response
+	httpResponse, err = client.Call(ctx, &httpRequest)
+	defer common.CloseBodyIfValid(httpResponse)
+	response.RawResponse = httpResponse
+	if err != nil {
+		return response, err
+	}
+
+	err = common.UnmarshalResponse(httpResponse, &response)
+	return response, err
+}
+
 // GetIPSecConnection Gets the specified IPSec connection's basic information, including the static routes for the
 // on-premises router. If you want the status of the connection (whether it's up or down), use
 // GetIPSecConnectionDeviceStatus.

core/core_virtualnetwork_client.go

@@ -46,6 +46,10 @@ type CreateCrossConnectDetails struct {
 	// location, and you want this new cross-connect to be on the same router, provide the
 	// OCID of that existing cross-connect or cross-connect group.
 	NearCrossConnectOrCrossConnectGroupId *string `mandatory:"false" json:"nearCrossConnectOrCrossConnectGroupId"`
+
+	// A reference name or identifier for the physical fiber connection that this cross-connect
+	// uses.
+	CustomerReferenceName *string `mandatory:"false" json:"customerReferenceName"`
 }
 
 func (m CreateCrossConnectDetails) String() string {

core/create_cross_connect_details.go

@@ -21,6 +21,10 @@ type CreateCrossConnectGroupDetails struct {
 	// A user-friendly name. Does not have to be unique, and it's changeable.
 	// Avoid entering confidential information.
 	DisplayName *string `mandatory:"false" json:"displayName"`
+
+	// A reference name or identifier for the physical fiber connection that this cross-connect
+	// group uses.
+	CustomerReferenceName *string `mandatory:"false" json:"customerReferenceName"`
 }
 
 func (m CreateCrossConnectGroupDetails) String() string {

core/create_cross_connect_group_details.go

@@ -43,7 +43,7 @@ type CreateImageDetails struct {
 	InstanceId *string `mandatory:"false" json:"instanceId"`
 
 	// Specifies the configuration mode for launching virtual machine (VM) instances. The configuration modes are:
-	// * `NATIVE` - VM instances launch with iSCSI boot and VFIO devices. The default value for Oracle-provided images.
+	// * `NATIVE` - VM instances launch with paravirtualized boot and VFIO devices. The default value for Oracle-provided images.
 	// * `EMULATED` - VM instances launch with emulated devices, such as the E1000 network driver and emulated SCSI disk controller.
 	// * `PARAVIRTUALIZED` - VM instances launch with paravirtualized devices using virtio drivers.
 	// * `CUSTOM` - VM instances launch with custom configuration settings specified in the `LaunchOptions` parameter.

core/create_image_details.go

@@ -55,6 +55,9 @@ type CreateVirtualCircuitDetails struct {
 	// ListFastConnectProviderServices.
 	ProviderServiceId *string `mandatory:"false" json:"providerServiceId"`
 
+	// The service key name offered by the provider (if the customer is connecting via a provider).
+	ProviderServiceKeyName *string `mandatory:"false" json:"providerServiceKeyName"`
+
 	// Deprecated. Instead use `providerServiceId`.
 	// To get a list of the provider names, see
 	// ListFastConnectProviderServices.

core/create_virtual_circuit_details.go

@@ -55,6 +55,10 @@ type CrossConnect struct {
 	// Example: `10 Gbps`
 	PortSpeedShapeName *string `mandatory:"false" json:"portSpeedShapeName"`
 
+	// A reference name or identifier for the physical fiber connection that this cross-connect
+	// uses.
+	CustomerReferenceName *string `mandatory:"false" json:"customerReferenceName"`
+
 	// The date and time the cross-connect was created, in the format defined by RFC3339.
 	// Example: `2016-08-25T21:10:29.600Z`
 	TimeCreated *common.SDKTime `mandatory:"false" json:"timeCreated"`

core/cross_connect.go

@@ -40,6 +40,10 @@ type CrossConnectGroup struct {
 	// The cross-connect group's current state.
 	LifecycleState CrossConnectGroupLifecycleStateEnum `mandatory:"false" json:"lifecycleState,omitempty"`
 
+	// A reference name or identifier for the physical fiber connection that this cross-connect
+	// group uses.
+	CustomerReferenceName *string `mandatory:"false" json:"customerReferenceName"`
+
 	// The date and time the cross-connect group was created, in the format defined by RFC3339.
 	// Example: `2016-08-25T21:10:29.600Z`
 	TimeCreated *common.SDKTime `mandatory:"false" json:"timeCreated"`

core/cross_connect_group.go

@@ -17,13 +17,13 @@ import (
 type ExportImageViaObjectStorageTupleDetails struct {
 
 	// The Object Storage bucket to export the image to.
-	BucketName *string `mandatory:"false" json:"bucketName"`
+	BucketName *string `mandatory:"true" json:"bucketName"`
 
 	// The Object Storage namespace to export the image to.
-	NamespaceName *string `mandatory:"false" json:"namespaceName"`
+	NamespaceName *string `mandatory:"true" json:"namespaceName"`
 
 	// The Object Storage object name for the exported image.
-	ObjectName *string `mandatory:"false" json:"objectName"`
+	ObjectName *string `mandatory:"true" json:"objectName"`
 }
 
 func (m ExportImageViaObjectStorageTupleDetails) String() string {

core/export_image_via_object_storage_tuple_details.go

@@ -17,7 +17,7 @@ import (
 type ExportImageViaObjectStorageUriDetails struct {
 
 	// The Object Storage URL to export the image to. See Object Storage URLs (https://docs.cloud.oracle.com/Content/Compute/Tasks/imageimportexport.htm#URLs)
-	// and pre-authenticated requests (https://docs.cloud.oracle.com/Content/Object/Tasks/managingaccess.htm#pre-auth) for constructing URLs for image import/export.
+	// and Using Pre-Authenticated Requests (https://docs.cloud.oracle.com/Content/Object/Tasks/usingpreauthenticatedrequests.htm) for constructing URLs for image import/export.
 	DestinationUri *string `mandatory:"true" json:"destinationUri"`
 }
 

core/export_image_via_object_storage_uri_details.go

@@ -31,6 +31,19 @@ type FastConnectProviderService struct {
 	// Who is responsible for managing the public peering BGP information.
 	PublicPeeringBgpManagement FastConnectProviderServicePublicPeeringBgpManagementEnum `mandatory:"true" json:"publicPeeringBgpManagement"`
 
+	// Who is responsible for managing the ASN information for the network at the other end
+	// of the connection from Oracle.
+	CustomerAsnManagement FastConnectProviderServiceCustomerAsnManagementEnum `mandatory:"true" json:"customerAsnManagement"`
+
+	// Who is responsible for managing the provider service key.
+	ProviderServiceKeyManagement FastConnectProviderServiceProviderServiceKeyManagementEnum `mandatory:"true" json:"providerServiceKeyManagement"`
+
+	// Who is responsible for managing the virtual circuit bandwidth.
+	BandwithShapeManagement FastConnectProviderServiceBandwithShapeManagementEnum `mandatory:"true" json:"bandwithShapeManagement"`
+
+	// Total number of cross-connect or cross-connect groups required for the virtual circuit.
+	RequiredTotalCrossConnects *int `mandatory:"true" json:"requiredTotalCrossConnects"`
+
 	// Provider service type.
 	Type FastConnectProviderServiceTypeEnum `mandatory:"true" json:"type"`
 
@@ -118,6 +131,81 @@ func GetFastConnectProviderServiceSupportedVirtualCircuitTypesEnumValues() []Fas
 	return values
 }
 
+// FastConnectProviderServiceCustomerAsnManagementEnum Enum with underlying type: string
+type FastConnectProviderServiceCustomerAsnManagementEnum string
+
+// Set of constants representing the allowable values for FastConnectProviderServiceCustomerAsnManagementEnum
+const (
+	FastConnectProviderServiceCustomerAsnManagementCustomerManaged FastConnectProviderServiceCustomerAsnManagementEnum = "CUSTOMER_MANAGED"
+	FastConnectProviderServiceCustomerAsnManagementProviderManaged FastConnectProviderServiceCustomerAsnManagementEnum = "PROVIDER_MANAGED"
+	FastConnectProviderServiceCustomerAsnManagementOracleManaged   FastConnectProviderServiceCustomerAsnManagementEnum = "ORACLE_MANAGED"
+)
+
+var mappingFastConnectProviderServiceCustomerAsnManagement = map[string]FastConnectProviderServiceCustomerAsnManagementEnum{
+	"CUSTOMER_MANAGED": FastConnectProviderServiceCustomerAsnManagementCustomerManaged,
+	"PROVIDER_MANAGED": FastConnectProviderServiceCustomerAsnManagementProviderManaged,
+	"ORACLE_MANAGED":   FastConnectProviderServiceCustomerAsnManagementOracleManaged,
+}
+
+// GetFastConnectProviderServiceCustomerAsnManagementEnumValues Enumerates the set of values for FastConnectProviderServiceCustomerAsnManagementEnum
+func GetFastConnectProviderServiceCustomerAsnManagementEnumValues() []FastConnectProviderServiceCustomerAsnManagementEnum {
+	values := make([]FastConnectProviderServiceCustomerAsnManagementEnum, 0)
+	for _, v := range mappingFastConnectProviderServiceCustomerAsnManagement {
+		values = append(values, v)
+	}
+	return values
+}
+
+// FastConnectProviderServiceProviderServiceKeyManagementEnum Enum with underlying type: string
+type FastConnectProviderServiceProviderServiceKeyManagementEnum string
+
+// Set of constants representing the allowable values for FastConnectProviderServiceProviderServiceKeyManagementEnum
+const (
+	FastConnectProviderServiceProviderServiceKeyManagementCustomerManaged FastConnectProviderServiceProviderServiceKeyManagementEnum = "CUSTOMER_MANAGED"
+	FastConnectProviderServiceProviderServiceKeyManagementProviderManaged FastConnectProviderServiceProviderServiceKeyManagementEnum = "PROVIDER_MANAGED"
+	FastConnectProviderServiceProviderServiceKeyManagementOracleManaged   FastConnectProviderServiceProviderServiceKeyManagementEnum = "ORACLE_MANAGED"
+)
+
+var mappingFastConnectProviderServiceProviderServiceKeyManagement = map[string]FastConnectProviderServiceProviderServiceKeyManagementEnum{
+	"CUSTOMER_MANAGED": FastConnectProviderServiceProviderServiceKeyManagementCustomerManaged,
+	"PROVIDER_MANAGED": FastConnectProviderServiceProviderServiceKeyManagementProviderManaged,
+	"ORACLE_MANAGED":   FastConnectProviderServiceProviderServiceKeyManagementOracleManaged,
+}
+
+// GetFastConnectProviderServiceProviderServiceKeyManagementEnumValues Enumerates the set of values for FastConnectProviderServiceProviderServiceKeyManagementEnum
+func GetFastConnectProviderServiceProviderServiceKeyManagementEnumValues() []FastConnectProviderServiceProviderServiceKeyManagementEnum {
+	values := make([]FastConnectProviderServiceProviderServiceKeyManagementEnum, 0)
+	for _, v := range mappingFastConnectProviderServiceProviderServiceKeyManagement {
+		values = append(values, v)
+	}
+	return values
+}
+
+// FastConnectProviderServiceBandwithShapeManagementEnum Enum with underlying type: string
+type FastConnectProviderServiceBandwithShapeManagementEnum string
+
+// Set of constants representing the allowable values for FastConnectProviderServiceBandwithShapeManagementEnum
+const (
+	FastConnectProviderServiceBandwithShapeManagementCustomerManaged FastConnectProviderServiceBandwithShapeManagementEnum = "CUSTOMER_MANAGED"
+	FastConnectProviderServiceBandwithShapeManagementProviderManaged FastConnectProviderServiceBandwithShapeManagementEnum = "PROVIDER_MANAGED"
+	FastConnectProviderServiceBandwithShapeManagementOracleManaged   FastConnectProviderServiceBandwithShapeManagementEnum = "ORACLE_MANAGED"
+)
+
+var mappingFastConnectProviderServiceBandwithShapeManagement = map[string]FastConnectProviderServiceBandwithShapeManagementEnum{
+	"CUSTOMER_MANAGED": FastConnectProviderServiceBandwithShapeManagementCustomerManaged,
+	"PROVIDER_MANAGED": FastConnectProviderServiceBandwithShapeManagementProviderManaged,
+	"ORACLE_MANAGED":   FastConnectProviderServiceBandwithShapeManagementOracleManaged,
+}
+
+// GetFastConnectProviderServiceBandwithShapeManagementEnumValues Enumerates the set of values for FastConnectProviderServiceBandwithShapeManagementEnum
+func GetFastConnectProviderServiceBandwithShapeManagementEnumValues() []FastConnectProviderServiceBandwithShapeManagementEnum {
+	values := make([]FastConnectProviderServiceBandwithShapeManagementEnum, 0)
+	for _, v := range mappingFastConnectProviderServiceBandwithShapeManagement {
+		values = append(values, v)
+	}
+	return values
+}
+
 // FastConnectProviderServiceTypeEnum Enum with underlying type: string
 type FastConnectProviderServiceTypeEnum string
 

core/fast_connect_provider_service.go

@@ -0,0 +1,34 @@
+// Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
+// Code generated. DO NOT EDIT.
+
+// Core Services API
+//
+// APIs for Networking Service, Compute Service, and Block Volume Service.
+//
+
+package core
+
+import (
+	"github.com/oracle/oci-go-sdk/common"
+)
+
+// FastConnectProviderServiceKey A provider service key and its details. A provider service key is an identifier for a provider's
+// virtual circuit.
+type FastConnectProviderServiceKey struct {
+
+	// The name of the service key offered by the provider.
+	Name *string `mandatory:"false" json:"name"`
+
+	// The provisioned data rate of the connection.  To get a list of the
+	// available bandwidth levels (that is, shapes), see
+	// ListFastConnectProviderVirtualCircuitBandwidthShapes.
+	// Example: `10 Gbps`
+	BandwidthShapeName *string `mandatory:"false" json:"bandwidthShapeName"`
+
+	// The provider's peering location.
+	PeeringLocation *string `mandatory:"false" json:"peeringLocation"`
+}
+
+func (m FastConnectProviderServiceKey) String() string {
+	return common.PointerString(m)
+}