feat(AIP-193): Include metadata and help link in example error (#1268)

* feat(AIP-193): Include metadata and help link in example error

* Update 0193.md

Author: andrei-scripniciuc

aip/general/0193.md

@@ -47,19 +47,29 @@ following:
     "details": [
       {
         "@type": "type.googleapis.com/google.rpc.ErrorInfo",
-        "reason": "STOCKOUT",
+        "reason": "RESOURCE_AVAILABILITY",
         "domain": "compute.googleapis.com",
         "metadata": {
           "zone": "us-east1-a",
           "vmType": "e2-medium",
-          "attachment": "local-ssd=3,nvidia-t4=2"
-         }
-       },
-       {
+          "attachment": "local-ssd=3,nvidia-t4=2",
+          "zonesWithCapacity": "us-central1-f,us-central1-c"
+        }
+      },
+      {
         "@type": "type.googleapis.com/google.rpc.LocalizedMessage",
         "locale": "en-US",
-        "message": "A e2-medium with local-ssd=3,nvidia-t4=2 is currently unavailable in the us-east1-a zone.\nCapacity changes frequently, so try your request in a different zone, with a different VM hardware configuration, or at a later time. For more information, see troubleshooting documentation."
-       }
+        "message": "An <e2-medium> VM instance with <local-ssd=3,nvidia-t4=2> is currently unavailable in the <us-east1-a> zone.\n Consider trying your request in the <us-central1-f,us-central1-c> zone(s), which currently has/have capacity to accommodate your request.\n Alternatively, you can try your request again with a different VM hardware configuration or at a later time. For more information, see the troubleshooting documentation."
+      },
+      {
+        "@type": "type.googleapis.com/google.rpc.Help",
+        "links": [
+          {
+            "description": "troubleshooting documentation",
+            "url": "https://cloud.google.com/compute/docs/resource-error"
+          }
+        ]
+      }
     ]
   }
 }