Skip to content

Commit 7976152

Browse files
Update Guidelines.md
1 parent 8137718 commit 7976152

File tree

1 file changed

+5
-3
lines changed

1 file changed

+5
-3
lines changed

azure/Guidelines.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -60,18 +60,20 @@ A Uniform Resource Locator (URL) is how developers access the resources of your
6060

6161
:white_check_mark: **DO** use this URL pattern:
6262
```text
63-
https://<service>.<cloud>/<tenant>/<service-root>/<resource-collection>/<resource-id>/
63+
https://<tenant>.<region>.<service>.<cloud>/<service-root>/<resource-collection>/<resource-id>
6464
```
6565

6666
Where:
6767
| Field | Description
6868
| - | - |
69+
| tenant | Regionally-unique ID representing tenant. Used for isolation, billing, quota enforcement, lifetime of resources, etc.
70+
| region | A code (see the table below) identifying the tenant's selected region.
6971
| service | Name of the service (ex: blobstore, servicebus, directory, or management)
7072
| cloud | Cloud domain name, e.g. `azure.net` (see Azure CLI's "az cloud list")
71-
| tenant | Globally-unique ID of container representing tenant isolation, billing, enforced quotas, lifetime of containers (ex: subscription UUID)
7273
| service&#x2011;root | Service-specific path (ex: blobcontainer, myqueue)
7374
| resource&#x2011;collection | Name of the collection, unabbreviated, pluralized
74-
| resource&#x2011;id | Value of the unique id property. This MUST be the raw string/number/guid value with no quoting but properly escaped to fit in a URL segment.
75+
| resource&#x2011;id | Id of resource within the resource-collection. This MUST be the raw string/number/guid value with no quoting but properly escaped to fit in a URL segment.
76+
7577

7678
:white_check_mark: **DO** use kebab-casing (preferred) or camel-casing for URL path segments. If the segment refers to a JSON field, use camel casing.
7779

0 commit comments

Comments
 (0)