v3: Add links to usage events

[#173239356]

Co-authored-by: Belinda Liu <bliu@pivotal.io>
Co-authored-by: Sarah Weinstein <sweinstein@pivotal.io>

Author: belinda-liu

app/presenters/v3/app_usage_event_presenter.rb

@@ -41,7 +41,8 @@ def to_hash
         instance_count: {
           current: usage_event.instance_count,
           previous: usage_event.previous_instance_count,
-        }
+        },
+        links: build_links
       }
     end
 
@@ -50,5 +51,11 @@ def to_hash
     def usage_event
       @resource
     end
+
+    def build_links
+      {
+        self: { href: url_builder.build_url(path: "/v3/app_usage_events/#{usage_event.guid}") }
+      }
+    end
   end
 end

app/presenters/v3/service_usage_event_presenter.rb

@@ -31,7 +31,8 @@ def to_hash
         service_broker: {
           guid: usage_event.service_broker_guid,
           name: usage_event.service_broker_name,
-        }
+        },
+        links: build_links
       }
     end
 
@@ -40,5 +41,11 @@ def to_hash
     def usage_event
       @resource
     end
+
+    def build_links
+      {
+        self: { href: url_builder.build_url(path: "/v3/service_usage_events/#{usage_event.guid}") }
+      }
+    end
   end
 end

docs/v3/source/includes/api_resources/_app_usage_events.erb

@@ -37,6 +37,11 @@
   "instance_count": {
     "current": 10,
     "previous": 5
+  },
+  "links": {
+    "self": {
+      "href": "https://api.example.org/v3/app_usage_events/a595fe2f-01ff-4965-a50c-290258ab8582"
+    }
   }
 }
 <% end %>
@@ -96,6 +101,11 @@
       "instance_count": {
         "current": 10,
         "previous": 5
+      },
+      "links": {
+        "self": {
+          "href": "https://api.example.org/v3/app_usage_events/a595fe2f-01ff-4965-a50c-290258ab8582"
+        }
       }
     }
   ]

docs/v3/source/includes/api_resources/_service_usage_events.erb

@@ -27,6 +27,11 @@
   "service_broker": {
     "guid": "guid-7cc11646-bf38-4f4e-b6e0-9581916a74d9",
     "name": "name-2929"
+  },
+  "links": {
+    "self": {
+      "href": "https://api.example.org/v3/service_usage_events/c9976002-96f4-435a-888e-db1e1178df62"
+    }
   }
 }
 <% end %>
@@ -76,6 +81,11 @@
       "service_broker": {
         "guid": "guid-7cc11646-bf38-4f4e-b6e0-9581916a74d9",
         "name": "name-2929"
+      },
+      "links": {
+        "self": {
+          "href": "https://api.example.org/v3/service_usage_events/c9976002-96f4-435a-888e-db1e1178df62"
+        }
       }
     }
   ]

spec/request/app_usage_events_spec.rb

@@ -189,6 +189,9 @@ def build_usage_event_json(app_usage_event)
       'instance_count' => {
         'current' => app_usage_event.instance_count,
         'previous' => nil
+      },
+      'links' => {
+        'self' => { 'href' => "#{link_prefix}/v3/app_usage_events/#{app_usage_event.guid}" },
       }
     }
   end

spec/request/service_usage_events_spec.rb

@@ -209,6 +209,9 @@ def build_usage_event_json(service_usage_event)
       'service_broker' => {
         'guid' => service_usage_event.service_broker_guid,
         'name' => service_usage_event.service_broker_name,
+      },
+      'links' => {
+        'self' => { 'href' => "#{link_prefix}/v3/service_usage_events/#{service_usage_event.guid}" },
       }
     }
   end

spec/unit/presenters/v3/app_usage_event_presenter_spec.rb

@@ -29,6 +29,7 @@
       expect(result[:memory_in_mb_per_instance][:previous]).to eq nil
       expect(result[:instance_count][:current]).to eq usage_event.instance_count
       expect(result[:instance_count][:previous]).to eq nil
+      expect(result[:links][:self][:href]).to eq "#{link_prefix}/v3/app_usage_events/#{usage_event.guid}"
     end
 
     context 'when the usage event is for a task' do

spec/unit/presenters/v3/service_usage_event_presenter_spec.rb

@@ -24,6 +24,7 @@
       expect(result[:service_offering][:name]).to eq usage_event.service_label
       expect(result[:service_broker][:guid]).to eq usage_event.service_broker_guid
       expect(result[:service_broker][:name]).to eq usage_event.service_broker_name
+      expect(result[:links][:self][:href]).to eq "#{link_prefix}/v3/service_usage_events/#{usage_event.guid}"
     end
   end
 end