From ea44d9dc9a5adf98d8440c99a9b24a6222e51192 Mon Sep 17 00:00:00 2001
From: Andrei Scripniciuc
 <46186670+andrei-scripniciuc@users.noreply.github.com>
Date: Tue, 21 Nov 2023 08:07:45 -0800
Subject: [PATCH] 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
---
 aip/general/0193.md | 24 +++++++++++++++++-------
 1 file changed, 17 insertions(+), 7 deletions(-)

diff --git a/aip/general/0193.md b/aip/general/0193.md
index dbd4ddfeef..d8ec5a7ade 100644
--- a/aip/general/0193.md
+++ b/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"
+          }
+        ]
+      }
     ]
   }
 }