GO SDK 5.4.0 Release

GO SDK 5.4.0 Release

Author: dshelbyo

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 
+## 5.4.0 - 2019-04-16
+### Added
+- Support for tagging dynamic groups in the Identity service
+- Support for updating network ACLs and license types for autonomous databases and autonomous data warehouses in the Database service
+- Support for editing static routes and IPSec remote IDs in the Virtual Networking service
+
 ## 5.3.0 - 2019-04-09
 ### Added
 - Support for etag and if-match headers (for optimistic concurrency control) in the Email service

common/version.go

@@ -15,7 +15,7 @@ import (
 // AttachLoadBalancerDetails Represents a load balancer that is to be attached to an instance pool.
 type AttachLoadBalancerDetails struct {
 
-	// The OCID of the load balancer to attach to the pool.
+	// The OCID of the load balancer to attach to the instance pool.
 	LoadBalancerId *string `mandatory:"true" json:"loadBalancerId"`
 
 	// The name of the backend set on the load balancer to add instances to.
@@ -24,7 +24,7 @@ type AttachLoadBalancerDetails struct {
 	// The port value to use when creating the backend set.
 	Port *int `mandatory:"true" json:"port"`
 
-	// Indicates which vnic on each instance in the pool should be used to associate with the load balancer. possible values are "PrimaryVnic" or the displayName of one of the secondary VNICs on the instance configuration that is associated to the instance pool.
+	// Indicates which VNIC on each instance in the pool should be used to associate with the load balancer. Possible values are "PrimaryVnic" or the displayName of one of the secondary VNICs on the instance configuration that is associated with the instance pool.
 	VnicSelection *string `mandatory:"true" json:"vnicSelection"`
 }
 

core/attach_load_balancer_details.go

@@ -58,7 +58,7 @@ func (client *ComputeManagementClient) ConfigurationProvider() *common.Configura
 	return client.config
 }
 
-// AttachLoadBalancer Attach load balancer to the instance pool.
+// AttachLoadBalancer Attach a load balancer to the instance pool.
 func (client ComputeManagementClient) AttachLoadBalancer(ctx context.Context, request AttachLoadBalancerRequest) (response AttachLoadBalancerResponse, err error) {
 	var ociResponse common.OCIResponse
 	policy := common.NoRetryPolicy()

core/core_computemanagement_client.go

@@ -2666,7 +2666,8 @@ func (client VirtualNetworkClient) getFastConnectProviderService(ctx context.Con
 	return response, err
 }
 
-// GetFastConnectProviderServiceKey Gets the specified provider service key's information.
+// GetFastConnectProviderServiceKey Gets the specified provider service key's information. Use this operation to validate a
+// provider service key. An invalid key returns a 404 error.
 func (client VirtualNetworkClient) GetFastConnectProviderServiceKey(ctx context.Context, request GetFastConnectProviderServiceKeyRequest) (response GetFastConnectProviderServiceKeyResponse, err error) {
 	var ociResponse common.OCIResponse
 	policy := common.NoRetryPolicy()

core/core_virtualnetwork_client.go

@@ -18,13 +18,13 @@ type CreateIpSecConnectionDetails struct {
 	// The OCID of the compartment to contain the IPSec connection.
 	CompartmentId *string `mandatory:"true" json:"compartmentId"`
 
-	// The OCID of the CPE.
+	// The OCID of the Cpe object.
 	CpeId *string `mandatory:"true" json:"cpeId"`
 
 	// The OCID of the DRG.
 	DrgId *string `mandatory:"true" json:"drgId"`
 
-	// Static routes to the CPE. At least one route must be included. The CIDR must not be a
+	// Static routes to the CPE. At least one route must be included. A static route's CIDR must not be a
 	// multicast address or class E address.
 	// Example: `10.0.1.0/24`
 	StaticRoutes []string `mandatory:"true" json:"staticRoutes"`
@@ -42,8 +42,44 @@ type CreateIpSecConnectionDetails struct {
 	// Resource Tags (https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm).
 	// Example: `{"Department": "Finance"}`
 	FreeformTags map[string]string `mandatory:"false" json:"freeformTags"`
+
+	// Your identifier for your CPE device. Can be either an IP address or a hostname (specifically, the
+	// fully qualified domain name (FQDN)). The type of identifier you provide here must correspond
+	// to the value for `cpeLocalIdentifierType`.
+	// If you don't provide a value, the `ipAddress` attribute for the Cpe
+	// object specified by `cpeId` is used as the `cpeLocalIdentifier`.
+	// Example IP address: `10.0.3.3`
+	// Example hostname: `cpe.example.com`
+	CpeLocalIdentifier *string `mandatory:"false" json:"cpeLocalIdentifier"`
+
+	// The type of identifier for your CPE device. The value you provide here must correspond to the value
+	// for `cpeLocalIdentifier`.
+	CpeLocalIdentifierType CreateIpSecConnectionDetailsCpeLocalIdentifierTypeEnum `mandatory:"false" json:"cpeLocalIdentifierType,omitempty"`
 }
 
 func (m CreateIpSecConnectionDetails) String() string {
 	return common.PointerString(m)
 }
+
+// CreateIpSecConnectionDetailsCpeLocalIdentifierTypeEnum Enum with underlying type: string
+type CreateIpSecConnectionDetailsCpeLocalIdentifierTypeEnum string
+
+// Set of constants representing the allowable values for CreateIpSecConnectionDetailsCpeLocalIdentifierTypeEnum
+const (
+	CreateIpSecConnectionDetailsCpeLocalIdentifierTypeIpAddress CreateIpSecConnectionDetailsCpeLocalIdentifierTypeEnum = "IP_ADDRESS"
+	CreateIpSecConnectionDetailsCpeLocalIdentifierTypeHostname  CreateIpSecConnectionDetailsCpeLocalIdentifierTypeEnum = "HOSTNAME"
+)
+
+var mappingCreateIpSecConnectionDetailsCpeLocalIdentifierType = map[string]CreateIpSecConnectionDetailsCpeLocalIdentifierTypeEnum{
+	"IP_ADDRESS": CreateIpSecConnectionDetailsCpeLocalIdentifierTypeIpAddress,
+	"HOSTNAME":   CreateIpSecConnectionDetailsCpeLocalIdentifierTypeHostname,
+}
+
+// GetCreateIpSecConnectionDetailsCpeLocalIdentifierTypeEnumValues Enumerates the set of values for CreateIpSecConnectionDetailsCpeLocalIdentifierTypeEnum
+func GetCreateIpSecConnectionDetailsCpeLocalIdentifierTypeEnumValues() []CreateIpSecConnectionDetailsCpeLocalIdentifierTypeEnum {
+	values := make([]CreateIpSecConnectionDetailsCpeLocalIdentifierTypeEnum, 0)
+	for _, v := range mappingCreateIpSecConnectionDetailsCpeLocalIdentifierType {
+		values = append(values, v)
+	}
+	return values
+}

core/create_ip_sec_connection_details.go

@@ -25,7 +25,15 @@ type CreateSubnetDetails struct {
 	// The OCID of the VCN to contain the subnet.
 	VcnId *string `mandatory:"true" json:"vcnId"`
 
-	// The availability domain to contain the subnet.
+	// Controls whether the subnet is regional or specific to an availability domain. Oracle
+	// recommends creating regional subnets because they're more flexible and make it easier to
+	// implement failover across availability domains. Originally, AD-specific subnets were the
+	// only kind available to use.
+	// To create a regional subnet, omit this attribute. Then any resources later created in this
+	// subnet (such as a Compute instance) can be created in any availability domain in the region.
+	// To instead create an AD-specific subnet, set this attribute to the availability domain you
+	// want this subnet to be in. Then any resources later created in this subnet can only be
+	// created in that availability domain.
 	// Example: `Uocm:PHX-AD-1`
 	AvailabilityDomain *string `mandatory:"false" json:"availabilityDomain"`
 
@@ -68,6 +76,7 @@ type CreateSubnetDetails struct {
 	// If `prohibitPublicIpOnVnic` is set to true, VNICs created in this
 	// subnet cannot have public IP addresses (that is, it's a private
 	// subnet).
+	//
 	// Example: `true`
 	ProhibitPublicIpOnVnic *bool `mandatory:"false" json:"prohibitPublicIpOnVnic"`
 

core/create_subnet_details.go

@@ -11,7 +11,7 @@ import (
 // DeleteInstanceConsoleConnectionRequest wrapper for the DeleteInstanceConsoleConnection operation
 type DeleteInstanceConsoleConnectionRequest struct {
 
-	// The OCID of the intance console connection
+	// The OCID of the instance console connection.
 	InstanceConsoleConnectionId *string `mandatory:"true" contributesTo:"path" name:"instanceConsoleConnectionId"`
 
 	// For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`

core/delete_instance_console_connection_request_response.go

@@ -15,10 +15,10 @@ import (
 // DetachLoadBalancerDetails Represents a load balancer that is to be detached from an instance pool.
 type DetachLoadBalancerDetails struct {
 
-	// The OCID of the load balancer to detach from the pool.
+	// The OCID of the load balancer to detach from the instance pool.
 	LoadBalancerId *string `mandatory:"true" json:"loadBalancerId"`
 
-	// The name of the backend set on the load balancer to detach from the pool.
+	// The name of the backend set on the load balancer to detach from the instance pool.
 	BackendSetName *string `mandatory:"true" json:"backendSetName"`
 }
 

core/detach_load_balancer_details.go

@@ -47,7 +47,10 @@ type FastConnectProviderService struct {
 	// Provider service type.
 	Type FastConnectProviderServiceTypeEnum `mandatory:"true" json:"type"`
 
-	// A description of the service offered by the provider.
+	// The location of the provider's website or portal. This portal is where you can get information
+	// about the provider service, create a virtual circuit connection from the provider to Oracle
+	// Cloud Infrastructure, and retrieve your provider service key for that virtual circuit connection.
+	// Example: `https://example.com`
 	Description *string `mandatory:"false" json:"description"`
 
 	// An array of virtual circuit types supported by this service.

core/fast_connect_provider_service.go

@@ -16,7 +16,10 @@ import (
 // virtual circuit.
 type FastConnectProviderServiceKey struct {
 
-	// The name of the service key offered by the provider.
+	// The service key that the provider gives you when you set up a virtual circuit connection
+	// from the provider to Oracle Cloud Infrastructure. Use this value as the `providerServiceKeyName`
+	// query parameter for
+	// GetFastConnectProviderServiceKey.
 	Name *string `mandatory:"false" json:"name"`
 
 	// The provisioned data rate of the connection.  To get a list of the

core/fast_connect_provider_service_key.go

@@ -14,7 +14,10 @@ type GetFastConnectProviderServiceKeyRequest struct {
 	// The OCID of the provider service.
 	ProviderServiceId *string `mandatory:"true" contributesTo:"path" name:"providerServiceId"`
 
-	// The provider service key name.
+	// The provider service key that the provider gives you when you set up a virtual circuit connection
+	// from the provider to Oracle Cloud Infrastructure. You can set up that connection and get your
+	// provider service key at the provider's website or portal. For the portal location, see the `description`
+	// attribute of the FastConnectProviderService.
 	ProviderServiceKeyName *string `mandatory:"true" contributesTo:"path" name:"providerServiceKeyName"`
 
 	// Unique Oracle-assigned identifier for the request.

core/get_fast_connect_provider_service_key_request_response.go

@@ -11,7 +11,7 @@ import (
 // GetInstanceConsoleConnectionRequest wrapper for the GetInstanceConsoleConnection operation
 type GetInstanceConsoleConnectionRequest struct {
 
-	// The OCID of the intance console connection
+	// The OCID of the instance console connection.
 	InstanceConsoleConnectionId *string `mandatory:"true" contributesTo:"path" name:"instanceConsoleConnectionId"`
 
 	// Unique Oracle-assigned identifier for the request.

core/get_instance_console_connection_request_response.go

@@ -15,13 +15,13 @@ import (
 // InstancePool Instance Pool
 type InstancePool struct {
 
-	// The OCID of the instance pool
+	// The OCID of the instance pool.
 	Id *string `mandatory:"true" json:"id"`
 
-	// The OCID of the compartment containing the instance pool
+	// The OCID of the compartment containing the instance pool.
 	CompartmentId *string `mandatory:"true" json:"compartmentId"`
 
-	// The OCID of the instance configuration associated to the intance pool.
+	// The OCID of the instance configuration associated with the instance pool.
 	InstanceConfigurationId *string `mandatory:"true" json:"instanceConfigurationId"`
 
 	// The current state of the instance pool.

core/instance_pool.go

@@ -15,7 +15,7 @@ import (
 // InstancePoolInstanceLoadBalancerBackend Represents the load balancer Backend that is configured for an instance pool instance.
 type InstancePoolInstanceLoadBalancerBackend struct {
 
-	// The OCID of the load balancer attached to the pool.
+	// The OCID of the load balancer attached to the instance pool.
 	LoadBalancerId *string `mandatory:"true" json:"loadBalancerId"`
 
 	// The name of the backend set on the load balancer.

core/instance_pool_instance_load_balancer_backend.go

@@ -21,7 +21,7 @@ type InstancePoolLoadBalancerAttachment struct {
 	// The OCID of the instance pool of the load balancer attachment.
 	InstancePoolId *string `mandatory:"true" json:"instancePoolId"`
 
-	// The OCID of the load balancer attached to the pool.
+	// The OCID of the load balancer attached to the instance pool.
 	LoadBalancerId *string `mandatory:"true" json:"loadBalancerId"`
 
 	// The name of the backend set on the load balancer.
@@ -30,10 +30,10 @@ type InstancePoolLoadBalancerAttachment struct {
 	// The port value used for the backends.
 	Port *int `mandatory:"true" json:"port"`
 
-	// Indicates which vnic on each instance in the pool should be used to associate with the load balancer. possible values are "PrimaryVnic" or the displayName of one of the secondary VNICs on the instance configuration that is associated to the instance pool.
+	// Indicates which VNIC on each instance in the instance pool should be used to associate with the load balancer. Possible values are "PrimaryVnic" or the displayName of one of the secondary VNICs on the instance configuration that is associated with the instance pool.
 	VnicSelection *string `mandatory:"true" json:"vnicSelection"`
 
-	// The status of the interaction between the pool and the load balancer.
+	// The status of the interaction between the instance pool and the load balancer.
 	LifecycleState InstancePoolLoadBalancerAttachmentLifecycleStateEnum `mandatory:"true" json:"lifecycleState"`
 }
 

core/instance_pool_load_balancer_attachment.go

@@ -21,7 +21,7 @@ type InstancePoolSummary struct {
 	// The OCID of the compartment containing the instance pool
 	CompartmentId *string `mandatory:"true" json:"compartmentId"`
 
-	// The OCID of the instance configuration associated to the intance pool.
+	// The OCID of the instance configuration associated with the instance pool.
 	InstanceConfigurationId *string `mandatory:"true" json:"instanceConfigurationId"`
 
 	// The current state of the instance pool.

core/instance_pool_summary.go

@@ -15,7 +15,7 @@ import (
 // InstanceSummary Condensed instance data when listing instances in an instance pool.
 type InstanceSummary struct {
 
-	// The OCID of the instance
+	// The OCID of the instance.
 	Id *string `mandatory:"true" json:"id"`
 
 	// The availability domain the instance is running in.
@@ -48,7 +48,7 @@ type InstanceSummary struct {
 	// You can enumerate all available shapes by calling ListShapes.
 	Shape *string `mandatory:"false" json:"shape"`
 
-	// The load balancer backends configured for the instance pool instance.
+	// The load balancer backends that are configured for the instance pool instance.
 	LoadBalancerBackends []InstancePoolInstanceLoadBalancerBackend `mandatory:"false" json:"loadBalancerBackends"`
 }
 

core/instance_summary.go

@@ -15,7 +15,7 @@ import (
 // IpSecConnection A connection between a DRG and CPE. This connection consists of multiple IPSec
 // tunnels. Creating this connection is one of the steps required when setting up
 // an IPSec VPN. For more information, see
-// Overview of the Networking Service (https://docs.cloud.oracle.com/Content/Network/Concepts/overview.htm).
+// IPSec VPN (https://docs.cloud.oracle.com/Content/Network/Tasks/managingIPsec.htm).
 // To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized,
 // talk to an administrator. If you're an administrator who needs to write policies to give users access, see
 // Getting Started with Policies (https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm).
@@ -26,7 +26,7 @@ type IpSecConnection struct {
 	// The OCID of the compartment containing the IPSec connection.
 	CompartmentId *string `mandatory:"true" json:"compartmentId"`
 
-	// The OCID of the CPE.
+	// The OCID of the Cpe object.
 	CpeId *string `mandatory:"true" json:"cpeId"`
 
 	// The OCID of the DRG.
@@ -58,6 +58,19 @@ type IpSecConnection struct {
 	// Example: `{"Department": "Finance"}`
 	FreeformTags map[string]string `mandatory:"false" json:"freeformTags"`
 
+	// Your identifier for your CPE device. Can be either an IP address or a hostname (specifically,
+	// the fully qualified domain name (FQDN)). The type of identifier here must correspond
+	// to the value for `cpeLocalIdentifierType`.
+	// If you don't provide a value when creating the IPSec connection, the `ipAddress` attribute
+	// for the Cpe object specified by `cpeId` is used as the `cpeLocalIdentifier`.
+	// Example IP address: `10.0.3.3`
+	// Example hostname: `cpe.example.com`
+	CpeLocalIdentifier *string `mandatory:"false" json:"cpeLocalIdentifier"`
+
+	// The type of identifier for your CPE device. The value here must correspond to the value
+	// for `cpeLocalIdentifier`.
+	CpeLocalIdentifierType IpSecConnectionCpeLocalIdentifierTypeEnum `mandatory:"false" json:"cpeLocalIdentifierType,omitempty"`
+
 	// The date and time the IPSec connection was created, in the format defined by RFC3339.
 	// Example: `2016-08-25T21:10:29.600Z`
 	TimeCreated *common.SDKTime `mandatory:"false" json:"timeCreated"`
@@ -93,3 +106,26 @@ func GetIpSecConnectionLifecycleStateEnumValues() []IpSecConnectionLifecycleStat
 	}
 	return values
 }
+
+// IpSecConnectionCpeLocalIdentifierTypeEnum Enum with underlying type: string
+type IpSecConnectionCpeLocalIdentifierTypeEnum string
+
+// Set of constants representing the allowable values for IpSecConnectionCpeLocalIdentifierTypeEnum
+const (
+	IpSecConnectionCpeLocalIdentifierTypeIpAddress IpSecConnectionCpeLocalIdentifierTypeEnum = "IP_ADDRESS"
+	IpSecConnectionCpeLocalIdentifierTypeHostname  IpSecConnectionCpeLocalIdentifierTypeEnum = "HOSTNAME"
+)
+
+var mappingIpSecConnectionCpeLocalIdentifierType = map[string]IpSecConnectionCpeLocalIdentifierTypeEnum{
+	"IP_ADDRESS": IpSecConnectionCpeLocalIdentifierTypeIpAddress,
+	"HOSTNAME":   IpSecConnectionCpeLocalIdentifierTypeHostname,
+}
+
+// GetIpSecConnectionCpeLocalIdentifierTypeEnumValues Enumerates the set of values for IpSecConnectionCpeLocalIdentifierTypeEnum
+func GetIpSecConnectionCpeLocalIdentifierTypeEnumValues() []IpSecConnectionCpeLocalIdentifierTypeEnum {
+	values := make([]IpSecConnectionCpeLocalIdentifierTypeEnum, 0)
+	for _, v := range mappingIpSecConnectionCpeLocalIdentifierType {
+		values = append(values, v)
+	}
+	return values
+}

core/ip_sec_connection.go

@@ -39,7 +39,8 @@ import (
 // supply string values using the API.
 type PrivateIp struct {
 
-	// The private IP's availability domain.
+	// The private IP's availability domain. This attribute will be null if this is a *secondary*
+	// private IP assigned to a VNIC that is in a *regional* subnet.
 	// Example: `Uocm:PHX-AD-1`
 	AvailabilityDomain *string `mandatory:"false" json:"availabilityDomain"`
 

core/private_ip.go

@@ -51,7 +51,8 @@ type Subnet struct {
 	// Example: `00:00:17:B6:4D:DD`
 	VirtualRouterMac *string `mandatory:"true" json:"virtualRouterMac"`
 
-	// The subnet's availability domain.
+	// The subnet's availability domain. This attribute will be null if this is a regional subnet
+	// instead of an AD-specific subnet. Oracle recommends creating regional subnets.
 	// Example: `Uocm:PHX-AD-1`
 	AvailabilityDomain *string `mandatory:"false" json:"availabilityDomain"`
 

core/subnet.go

@@ -29,7 +29,7 @@ type UpdateInstancePoolDetails struct {
 	// Example: `{"Department": "Finance"}`
 	FreeformTags map[string]string `mandatory:"false" json:"freeformTags"`
 
-	// The OCID of the instance configuration associated to the intance pool.
+	// The OCID of the instance configuration associated with the instance pool.
 	InstanceConfigurationId *string `mandatory:"false" json:"instanceConfigurationId"`
 
 	// The placement configurations for the instance pool.