Release v2.4.0 (#126)

* Releasing version 2.4.0

Author: jasonyin

CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 
+## 2.3.0 - 2018-09-06
+### Added
+- Added support for updating metadata fields on an instance in the Compute service
+
 ## 2.3.0 - 2018-08-23
 ### Added
 - Support for fault domain in the Identity Service

Makefile

@@ -1,6 +1,6 @@
 DOC_SERVER_URL=https:\/\/docs.us-phoenix-1.oraclecloud.com
 
-GEN_TARGETS = identity core objectstorage loadbalancer database audit dns filestorage email containerengine resourcesearch
+GEN_TARGETS = identity core objectstorage loadbalancer database audit dns filestorage email containerengine resourcesearch ##SPECNAME##
 NON_GEN_TARGETS = common common/auth
 TARGETS = $(NON_GEN_TARGETS) $(GEN_TARGETS)
 

common/version.go

@@ -14,7 +14,7 @@ type AttachServiceIdRequest struct {
 	// The service gateway's OCID (https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm).
 	ServiceGatewayId *string `mandatory:"true" contributesTo:"path" name:"serviceGatewayId"`
 
-	// ServiceId of Service to be attached to a Service Gateway.
+	// ServiceId of Service to be attached to a service gateway.
 	AttachServiceDetails ServiceIdRequestDetails `contributesTo:"body"`
 
 	// For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`

core/attach_service_id_request_response.go

@@ -18,9 +18,11 @@ import (
 // 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.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+// **Warning:** Oracle recommends that you avoid using any confidential information when you
+// supply string values using the API.
 type BootVolume struct {
 
-	// The Availability Domain of the boot volume.
+	// The availability domain of the boot volume.
 	// Example: `Uocm:PHX-AD-1`
 	AvailabilityDomain *string `mandatory:"true" json:"availabilityDomain"`
 
@@ -64,7 +66,7 @@ type BootVolume struct {
 	// The size of the boot volume in GBs.
 	SizeInGBs *int64 `mandatory:"false" json:"sizeInGBs"`
 
-	// The boot volume source, either an existing boot volume in the same Availability Domain or a boot volume backup.
+	// The boot volume source, either an existing boot volume in the same availability domain or a boot volume backup.
 	// If null, this means that the boot volume was created from an image.
 	SourceDetails BootVolumeSourceDetails `mandatory:"false" json:"sourceDetails"`
 

core/boot_volume.go

@@ -13,9 +13,11 @@ import (
 )
 
 // BootVolumeAttachment Represents an attachment between a boot volume and an instance.
+// **Warning:** Oracle recommends that you avoid using any confidential information when you
+// supply string values using the API.
 type BootVolumeAttachment struct {
 
-	// The Availability Domain of an instance.
+	// The availability domain of an instance.
 	// Example: `Uocm:PHX-AD-1`
 	AvailabilityDomain *string `mandatory:"true" json:"availabilityDomain"`
 

core/boot_volume_attachment.go

@@ -19,6 +19,8 @@ import (
 // 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.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+// **Warning:** Oracle recommends that you avoid using any confidential information when you
+// supply string values using the API.
 type BootVolumeBackup struct {
 
 	// The OCID of the compartment that contains the boot volume backup.

core/boot_volume_backup.go

@@ -15,9 +15,11 @@ import (
 // ConsoleHistory An instance's serial console data. It includes configuration messages that occur when the
 // instance boots, such as kernel and BIOS messages, and is useful for checking the status of
 // the instance or diagnosing problems. The console data is minimally formatted ASCII text.
+// **Warning:** Oracle recommends that you avoid using any confidential information when you
+// supply string values using the API.
 type ConsoleHistory struct {
 
-	// The Availability Domain of an instance.
+	// The availability domain of an instance.
 	// Example: `Uocm:PHX-AD-1`
 	AvailabilityDomain *string `mandatory:"true" json:"availabilityDomain"`
 

core/console_history.go

@@ -153,11 +153,11 @@ func (client BlockstorageClient) createBootVolumeBackup(ctx context.Context, req
 // 50 GB (51200 MB) to 32 TB (33554432 MB), in 1 GB (1024 MB) increments. By default, volumes are 1 TB (1048576 MB).
 // For general information about block volumes, see
 // Overview of Block Volume Service (https://docs.us-phoenix-1.oraclecloud.com/Content/Block/Concepts/overview.htm).
-// A volume and instance can be in separate compartments but must be in the same Availability Domain.
+// A volume and instance can be in separate compartments but must be in the same availability domain.
 // For information about access control and compartments, see
 // Overview of the IAM Service (https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/overview.htm). For information about
-// Availability Domains, see Regions and Availability Domains (https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/regions.htm).
-// To get a list of Availability Domains, use the `ListAvailabilityDomains` operation
+// availability domains, see Regions and Availability Domains (https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/regions.htm).
+// To get a list of availability domains, use the `ListAvailabilityDomains` operation
 // in the Identity and Access Management Service API.
 // You may optionally specify a *display name* for the volume, which is simply a friendly name or
 // description. It does not have to be unique, and you can change it. Avoid entering confidential information.
@@ -1105,7 +1105,7 @@ func (client BlockstorageClient) listBootVolumeBackups(ctx context.Context, requ
 	return response, err
 }
 
-// ListBootVolumes Lists the boot volumes in the specified compartment and Availability Domain.
+// ListBootVolumes Lists the boot volumes in the specified compartment and availability domain.
 func (client BlockstorageClient) ListBootVolumes(ctx context.Context, request ListBootVolumesRequest) (response ListBootVolumesResponse, err error) {
 	var ociResponse common.OCIResponse
 	policy := common.NoRetryPolicy()
@@ -1317,7 +1317,7 @@ func (client BlockstorageClient) listVolumeGroups(ctx context.Context, request c
 	return response, err
 }
 
-// ListVolumes Lists the volumes in the specified compartment and Availability Domain.
+// ListVolumes Lists the volumes in the specified compartment and availability domain.
 func (client BlockstorageClient) ListVolumes(ctx context.Context, request ListVolumesRequest) (response ListVolumesResponse, err error) {
 	var ociResponse common.OCIResponse
 	policy := common.NoRetryPolicy()

core/core_blockstorage_client.go

@@ -1088,14 +1088,14 @@ func (client ComputeClient) instanceAction(ctx context.Context, request common.O
 	return response, err
 }
 
-// LaunchInstance Creates a new instance in the specified compartment and the specified Availability Domain.
+// LaunchInstance Creates a new instance in the specified compartment and the specified availability domain.
 // For general information about instances, see
 // Overview of the Compute Service (https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/Concepts/computeoverview.htm).
 // For information about access control and compartments, see
 // Overview of the IAM Service (https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/overview.htm).
-// For information about Availability Domains, see
+// For information about availability domains, see
 // Regions and Availability Domains (https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/regions.htm).
-// To get a list of Availability Domains, use the `ListAvailabilityDomains` operation
+// To get a list of availability domains, use the `ListAvailabilityDomains` operation
 // in the Identity and Access Management Service API.
 // All Oracle Cloud Infrastructure resources, including instances, get an Oracle-assigned,
 // unique ID called an Oracle Cloud Identifier (OCID).
@@ -1329,7 +1329,7 @@ func (client ComputeClient) listInstanceConsoleConnections(ctx context.Context,
 	return response, err
 }
 
-// ListInstances Lists the instances in the specified compartment and the specified Availability Domain.
+// ListInstances Lists the instances in the specified compartment and the specified availability domain.
 // You can filter the results by specifying an instance name (the list will include all the identically-named
 // instances in the compartment).
 func (client ComputeClient) ListInstances(ctx context.Context, request ListInstancesRequest) (response ListInstancesResponse, err error) {
@@ -1418,7 +1418,7 @@ func (client ComputeClient) listShapes(ctx context.Context, request common.OCIRe
 
 // ListVnicAttachments Lists the VNIC attachments in the specified compartment. A VNIC attachment
 // resides in the same compartment as the attached instance. The list can be
-// filtered by instance, VNIC, or Availability Domain.
+// filtered by instance, VNIC, or availability domain.
 func (client ComputeClient) ListVnicAttachments(ctx context.Context, request ListVnicAttachmentsRequest) (response ListVnicAttachmentsResponse, err error) {
 	var ociResponse common.OCIResponse
 	policy := common.NoRetryPolicy()
@@ -1652,7 +1652,10 @@ func (client ComputeClient) updateImage(ctx context.Context, request common.OCIR
 	return response, err
 }
 
-// UpdateInstance Updates the display name of the specified instance. Avoid entering confidential information.
+// UpdateInstance Updates certain fields on the specified instance. Fields that are not provided in the
+// request will not be updated. Avoid entering confidential information.
+// Changes to metadata fields will be reflected in the instance metadata service (this may take
+// up to a minute).
 // The OCID of the instance remains the same.
 func (client ComputeClient) UpdateInstance(ctx context.Context, request UpdateInstanceRequest) (response UpdateInstanceResponse, err error) {
 	var ociResponse common.OCIResponse