diff --git a/api-ref/src/docbkx/api-ref.xml b/api-ref/src/docbkx/api-ref.xml
index 551b7a3d8..960f26de4 100644
--- a/api-ref/src/docbkx/api-ref.xml
+++ b/api-ref/src/docbkx/api-ref.xml
@@ -146,7 +146,8 @@
Extended Availability Zones
- Shows the instance availability zone.
+ Shows the instance availability zone for compute nodes (nova-compute).
+ Internal services appear in their own internal availability zone.
diff --git a/api-ref/src/wadls/compute-api/src/ext/os-aggregates.wadl b/api-ref/src/wadls/compute-api/src/ext/os-aggregates.wadl
index 102856443..fa1249e9c 100644
--- a/api-ref/src/wadls/compute-api/src/ext/os-aggregates.wadl
+++ b/api-ref/src/wadls/compute-api/src/ext/os-aggregates.wadl
@@ -10,7 +10,7 @@
-
+
The ID for the tenant or account in a multi-tenancy cloud.
@@ -20,7 +20,7 @@
-
+
The ID associated with an aggregate.
@@ -66,12 +66,12 @@
-
+
Name of aggregate
-
+
Availability zone of aggregate
@@ -133,14 +133,14 @@
-
+
- Name of aggregate
+ Name of aggregate.
-
+
- Availability zone of aggregate
+ Availability zone of aggregate.
@@ -186,7 +186,7 @@
-
+
Metadata value to be set.
@@ -222,7 +222,7 @@
-
+
Host ID to add to an aggregate, which is a collection of multiple groups of hosts that share common resources like storage and network.
@@ -259,7 +259,7 @@
-
+
Host ID to add to an aggregate.
diff --git a/api-ref/src/wadls/compute-api/src/ext/os-ext-az.wadl b/api-ref/src/wadls/compute-api/src/ext/os-ext-az.wadl
index 0a92a4a76..633a07a61 100644
--- a/api-ref/src/wadls/compute-api/src/ext/os-ext-az.wadl
+++ b/api-ref/src/wadls/compute-api/src/ext/os-ext-az.wadl
@@ -1,6 +1,6 @@
-
+
-
+
+ xmlns:wadl="http://wadl.dev.java.net/2009/02"
+ xmlns:xsd="http://www.w3.org/2001/XMLSchema">