Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
86 commits
Select commit Hold shift + click to select a range
e37bdcd
Move CODEOWNERS file to .github directory and see what happens (#29401)
JimSuplizio Jun 11, 2024
4ee6d9f
Revert "Update TypeSpec for DeviceRegistry (#29319)" (#29398)
davidemontanari Jun 11, 2024
de1f377
Change readme.md to allow generation of latest python SDK (#29345)
mentat9 Jun 12, 2024
6c4f3c6
[scvmm&azure fleet&oracle] update python config (#29393)
ChenxiJiang333 Jun 12, 2024
7d87288
Release purview microsoft.purview preview/2024 04 01 preview (#28792)
ddumesnil-microsoft Jun 12, 2024
8e8e199
Video Indexer Private Endpoint Onboarding (#29266)
tshaiman Jun 12, 2024
e471d1f
added format for date-time (#29306)
brrusino Jun 12, 2024
259fe9a
Remove Microsoft.SecurityDevOps RP (#29326)
JohnathonMohr Jun 12, 2024
c0409c4
[package.json] Add devDependency "oav" (#29296)
mikeharder Jun 12, 2024
a8c212b
[ci-fix] Add docs for two common LintDiff errors in TypeSpec specs (#…
mikeharder Jun 12, 2024
3dbffd0
[DevCenter]Add JS api-version (#29423)
drielenr Jun 13, 2024
ed23c08
Security enhancement feature snowflake support storage integration (#…
ruowan Jun 13, 2024
412364b
Fix missing property in existing APIs (#29383)
calecarter Jun 13, 2024
eeb6a46
Change two property types for route spec (#28576)
jecmenicanikola Jun 13, 2024
a89c175
Examples Changes and move VMSS list operation inside fleets resource …
SahilArora92 Jun 13, 2024
a399f30
add preview api version missing from documentation (#29378)
abhayohri Jun 13, 2024
30c95a2
Enable linter for azure-rest-api-specs (#29434)
JimSuplizio Jun 13, 2024
2209f9b
tsp, avs, rename List API response schema back to ##List (#29408)
weidongxu-microsoft Jun 14, 2024
7bf13ef
avs, mgmt, rename schema via directive, for SDK backward-compatibilit…
weidongxu-microsoft Jun 14, 2024
db63bea
Update TypeSpec to latest 2024-06 release - 0.57 & 0.43 (#29440)
allenjzhang Jun 14, 2024
bbd815a
Microsoft.DesktopVirtualization 2024-04-08-preview (#29101)
almat-msft Jun 14, 2024
5013616
[Microsoft.DocumentDB] Bug fix for stable API Version 2024-05-15 (#29…
pjohari-ms Jun 14, 2024
ee38bd5
Update CodeownersLinter version to 1.0.0-dev.20240614.4 (#29450)
JimSuplizio Jun 14, 2024
d05250b
avs, mgmt, fix incorrect tsp of dnsServices int32 (#29395)
weidongxu-microsoft Jun 17, 2024
f1546dc
tsp, avs, remove Update model to keep consistency with stable Swagger…
weidongxu-microsoft Jun 17, 2024
125223f
[Azure Load Testing] Introduce 2024-05-01-preview API version (#29352)
mitsha-microsoft Jun 17, 2024
c1621be
Added information to the query uri parameter: 'Weather information is…
stevemunk Jun 17, 2024
62da663
adding typespec for stable version (#28694)
banggaurav Jun 17, 2024
20b4195
Release app microsoft.app 2024 02 02 preview (#29312)
Juliehzl Jun 17, 2024
c0a830f
Move 2024-05-01-preview for CDN private specs to public (#29369)
ChenglongLiu Jun 17, 2024
963641f
Deesharma/connectedclusternewversion (#29148)
deeksha345 Jun 18, 2024
7d5a68d
Update detection description (#29457)
Han-msft Jun 18, 2024
641b679
[AppComplianceAutomation] update python config (#29455)
ChenxiJiang333 Jun 18, 2024
ba1f6b2
[Azure Load Testing] Updated FileType.URL_TEST_CONFIG_JSON to FileTyp…
mitsha-microsoft Jun 18, 2024
51cbd0e
Fix foundation types in azure fleet (#29477)
SahilArora92 Jun 18, 2024
dde5c5c
Adding new version "2024-06-15-preview" in Microsoft.Elastic with Res…
poshett Jun 18, 2024
baf818e
mgmt, java config in readme.java.md (#29478)
weidongxu-microsoft Jun 18, 2024
c54a97d
Update api description (#29431)
yifan-zhou922 Jun 18, 2024
beaa815
update options (#29484)
billwert Jun 18, 2024
7911277
update code owners (#29485)
mryanlo Jun 18, 2024
9f02412
[EG] Update ReadME (#29481)
l0lawrence Jun 18, 2024
084b190
[scvmm] disable flatten (#29479)
ChenxiJiang333 Jun 19, 2024
fac5e7b
[appcomplianceautomation] title&disable flatten (#29480)
ChenxiJiang333 Jun 19, 2024
9942cf2
Update tspconfig.yaml (#29476)
haolingdong-msft Jun 19, 2024
061505b
Update the name from ResourceProvisioningState to ProvisioningState (…
MaryGao Jun 19, 2024
89fc547
mgmt, java config, client/title for appcomplianceautomation (#29498)
weidongxu-microsoft Jun 19, 2024
d15d528
Update description of runId to infer customer to use new GUID for cre…
mschaofan Jun 19, 2024
b48d5d7
Guptavertika/release network microsoft.network official 2024 01 01 (#…
GuptaVertika Jun 19, 2024
768c1f3
fix endpoint (#29508)
catalinaperalta Jun 19, 2024
0e86709
Update tspconfig.yaml (#29491)
ChenxiJiang333 Jun 20, 2024
cc92c59
update (#29522)
msyyc Jun 20, 2024
d0f12e0
ahila devcenter Microsoft.DevCenter 2024-06-01-preview API version (#…
ArberH Jun 20, 2024
c858811
Oracle.Database. Version 2023-09-01 stable (#29397)
v-maksymm Jun 20, 2024
d129670
[AKV] Add new preview version for NSP feature (#28893)
osmuller Jun 20, 2024
7cc354f
fix ComponentsByRelease for AKS 2024-04-02 preview api (#29425)
HuShaoRu Jun 21, 2024
0fdc8c8
Change 2024-05-01 to 2024-05-01-preview (#29441)
dw511214992 Jun 21, 2024
150e10e
Create sdk-automation-faq.md (#29537)
raych1 Jun 21, 2024
7753cb8
Add new api version 2024-04-01-preview for Azure SignalR and Azure We…
bjqian Jun 21, 2024
8db92d6
disable flatten for JS for mongocluster, deploymentstacks and appcomp…
kazrael2119 Jun 21, 2024
1d96e34
Update documentation for Azure Maps Route v1 API (#29524)
stevemunk Jun 21, 2024
a0ace9e
Moving missed changes from 2023-11-01 packet capture swagger fix to l…
nikhilpadhye1 Jun 21, 2024
8dd3c52
Fixes for x-ms-examples used in 2023 API specification validation (#2…
ajtms Jun 22, 2024
a83c343
Fix secret source url format (#29475)
ChenglongLiu Jun 22, 2024
9f9d14b
[powerbiembedded] Update readme.md (#29551)
msyyc Jun 24, 2024
8060dff
Added `stream-style-serialization: false` in `readme.java.md`. (#29542)
v-hongli1 Jun 24, 2024
ec7ee88
network, java directive (#29552)
weidongxu-microsoft Jun 24, 2024
a8f672a
Update sdk automation document (#29553)
raych1 Jun 24, 2024
f28f14c
Make "marketplaceSubscriptionId" an optional field for "MarketplaceDe…
almasak Jun 24, 2024
710e53c
Introduce Microsoft Fabric ARM Rest APIs (#29355)
badeamarjieh Jun 24, 2024
14e15e4
add new GA version: 2023-12-30 for Microsoft.DBForMySQL (#29031)
xiaoxuqi-ms Jun 24, 2024
d1fe957
fix docs creating bad docstrings in purview (#29558)
kristapratico Jun 24, 2024
0ce2859
Microsoft.Kubernetes to add preview version 2024-07-01-preview (#29487)
bavneetsingh16 Jun 25, 2024
356aa51
Add Web PubSub data plane version 2024-01-01 (#29445)
Y-Sindo Jun 25, 2024
3aef2f9
Added 2023-12-01 preview API for Azure Load Testing Control Plane (#2…
mitsha-microsoft Jun 25, 2024
0ee177a
Update DiskRestorePoint_Get_WhenSourceResourceIsFromDifferentRegion.j…
kbaibhavgithub Jun 25, 2024
053f21f
fix docs creating bad docstrings in healthinsights (#29557)
kristapratico Jun 25, 2024
9221ebd
Microsoft.DevCenter 2024-07-01-preview (#29527)
tbyfield Jun 25, 2024
a220053
Text Translation: Enable stream style serialization (#29509)
srnagar Jun 25, 2024
1c63635
Update readme.python.md (#29587)
msyyc Jun 26, 2024
db377f4
[StorageTasks] Bugfix maxpagesize type (#29534)
golddove Jun 26, 2024
0ed912f
Billing/2024 04 01 (#28160)
bradenwatkins Jun 26, 2024
2b6c728
Microsoft.ContainerInstance: Added API version 2024-05-01-preview (#2…
drishtipeshwani09 Jun 26, 2024
c286401
use body root to specify which parameter models we want to keep group…
iscai-msft Jun 26, 2024
43f10d3
hybridcompute - update readme.md and description for SDK commands gen…
yaotongms Jun 26, 2024
220ad9c
Move TypeSpec content from ci-fix.md to wiki (#29600)
mikeharder Jun 27, 2024
22a921d
Merge branch 'Azure:main' into patch-4
kbaibhavgithub Jun 27, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
The diff you're trying to view is too large. We only load the first 3000 changed files.
3 changes: 3 additions & 0 deletions CODEOWNERS → .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,9 @@

/specification/deploymentmanager/ @netrock

# PRLabel: %Device Registry
/specification/deviceregistry/ @marcodalessandro @rohankhandelwal @riteshrao

# PRLabel: %Device Update
/specification/deviceupdate/data-plane/ @mikekistler @Azure/api-stewardship-board

Expand Down
143 changes: 143 additions & 0 deletions .github/CODEOWNERS_baseline_errors.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,143 @@
Azure/api-stewardship-board is an invalid team. Ensure the team exists and has write permissions.
nickghardwick is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
minhanh-phan is not a public member of Azure.
assafi is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
rokulka is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
ChongTang is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
Azure/adp is an invalid team. Ensure the team exists and has write permissions.
taiwu is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
ofirmanor is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
olalavi is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
erangon is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
orieldar is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
ilaizi is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
shakednai1 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
orenhor is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
promoisha is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
alexeldeib is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
ramthi is not a public member of Azure.
'Container Apps' is not a valid label for this repository.
jijohn14 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
Juliehzl is not a public member of Azure.
/specification/codesigning/data-plane path or file does not exist in repository.
/specification/asazure/ path or file does not exist in repository.
athipp is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
darshanhs90 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
vrdmr is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
deathly809 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
dpwatrous is not a public member of Azure.
/specification/batchai/ path or file does not exist in repository.
alexanderyukhanov is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
asarkar84 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
jorinmejia is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
yunhemsft is not a public member of Azure.
jessicl-ms is not a public member of Azure.
rrahulms is not a public member of Azure.
t-bzhan is not a public member of Azure.
felixwa is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
'Cognitive Services - Form Recognizer' is not a valid label for this repository.
bojunehsu is not a public member of Azure.
nizi1127 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
bilaakpan-ms is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
dkulkarni-ms is not a public member of Azure.
MS-syh2qs is not a public member of Azure.
grizzlytheodore is not a public member of Azure.
mabhard is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
danielli90 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
smotwani is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
ppatwa is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
vikramd-ms is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
yunusm is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
ZhidongPeng is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
nkuchta is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
maheshnemichand is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
najams is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
changov is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
kjeur is not a public member of Azure.
panda-wang is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
novinc is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
djyou is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
weinong is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
seguler is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
alvinli222 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
justindavies is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
robbiezhang is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
paulgmiller is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
yizhang4321 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
circy9 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
qike-ms is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
MehaKaushik is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
tjlvtao is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
zhangyd2015 is not a public member of Azure.
davidzhaoyue is not a public member of Azure.
ro-joowan is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
hitenjava is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
/specification/deploymentmanager/ path or file does not exist in repository.
netrock is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
/specification/documentdb/ path or file does not exist in repository.
dmakwana is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
jihochang is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
Kishp01 is not a public member of Azure.
ahamad-MS is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
damodaravadhani is not a public member of Azure.
/specification/features/ path or file does not exist in repository.
yugangw-msft is not a public member of Azure.
amarzavery is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
pulkittomar is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
wawon-msft is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
/specification/insights/ path or file does not exist in repository.
gucalder is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
vrmurthy01 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
randallilama is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
jlichwa is not a public member of Azure.
pankajsn is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
tonytang-microsoft-com is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
nonstatic2014 is not a public member of Azure.
/specification/machinelearningcompute/ path or file does not exist in repository.
shutchings is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
jeffrey-ace is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
giakas is not a public member of Azure.
amolr is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
smithab is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
sw47 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
dashimi16 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
rileymckenna is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
pilor is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
tarostok is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
/specification/postgresql/** ends with an unsupported sequence '/**' and will not match. Replace it with '/'
/specification/provisioningservices/ path or file does not exist in repository.
kvish is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
dragonfly91 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
sonathan is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
dheerendrarathor is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
avneeshrai is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
siddharthchatrolams is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
timlovellsmith is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
Azure/arm-template-deployments is an invalid team. Ensure the team exists and has write permissions.
rajshah11 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
vivsriaus is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
pinwang81 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
bleroy is not a public member of Azure.
tjacobhi is not a public member of Azure.
amitchat is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
craigw is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
asinn826 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
daveirwin1 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
juhacket is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
samedder is not a public member of Azure.
jamestao is not a public member of Azure.
ericshape is not a public member of Azure.
leoz-ms is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
manaas-microsoft is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
atpham256 is not a public member of Azure.
/specification/subscriptions/ path or file does not exist in repository.
navysingla is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
yanjungao718 is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
sandshadow is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
allencal is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
hrkulkarmsft is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
naveedaz is not a public member of Azure.
Azure/azure-app-service-control-plane is an invalid team. Ensure the team exists and has write permissions.
'AzureML - Compute Instance' is not a valid label for this repository.
Azure/aml-compute-instance is an invalid team. Ensure the team exists and has write permissions.
shahabhijeet is an invalid user. Ensure the user exists, is public member of Azure and has write permissions.
14 changes: 14 additions & 0 deletions cSpell.json
Original file line number Diff line number Diff line change
Expand Up @@ -149,6 +149,14 @@
"Accesskey"
]
},
{
"filename": "**/specification/billing/**/*.json",
"words": [
"mosp",
"resellee",
"cnpj"
]
},
{
"filename": "**/specification/compute/resource-manager/Microsoft.ContainerService/preview/2015-11-01-preview/containerService.json",
"words": [
Expand Down Expand Up @@ -247,6 +255,12 @@
"otlp"
]
},
{
"filename": "**/specification/app/resource-manager/Microsoft.App/preview/2024-02-02-preview/ContainerApps.json",
"words": [
"workflowapp"
]
},
{
"filename": "**/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/6.2/servicefabric.json",
"words": [
Expand Down
1 change: 1 addition & 0 deletions custom-words.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1868,6 +1868,7 @@ myvolume
myworkbooks
n'eventtype
n'recognition
nacos
nadella
nagios
nameserver
Expand Down
71 changes: 4 additions & 67 deletions documentation/ci-fix.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,8 @@ If you need help with your specs PR, please first thoroughly read the [aka.ms/az
- [`AvoidAnonymousParameter`, `AvoidAnonymousTypes`, `IntegerTypeMustHaveFormat`](#avoidanonymousparameter-avoidanonymoustypes-integertypemusthaveformat)
- [`AvoidAnonymousTypes` inside a 202 response](#avoidanonymoustypes-inside-a-202-response)
- [`OAuth2Auth` causes `XmsEnumValidation`](#oauth2auth-causes-xmsenumvalidation)
- [`ProvisioningStateMustBeReadOnly`](#provisioningstatemustbereadonly)
- [`PatchBodyParameterSchema`](#patchbodyparameterschema)
- [`Swagger ModelValidation`](#swagger-modelvalidation)
- [`Swagger PrettierCheck`](#swagger-prettiercheck)
- [Prettier reference](#prettier-reference)
Expand Down Expand Up @@ -188,53 +190,7 @@ To reproduce LintDiff failures locally, see [CONTRIBUTING.md / How to locally re

## `Swagger LintDiff` for TypeSpec: troubleshooting guides

Check `Swagger LintDiff` may fail for the OpenAPI generated from TypeSpec, even if there are no warnings or errors reported from the TypeSpec compiler. Causes include bugs in the TypeSpec OpenAPI emitter, bugs in LintDiff rules, incompatibilities between TypeSpec and LintDiff, or checks duplicated in TypeSpec and LintDiff.

We are working to address the root causes (where possible). Until then, we recommend you [suppress](#suppression-process) these LintDiff errors, using a "permanent suppression" with a descriptive "reason", so we can revert your suppression when the root cause is fixed.

### `Record<unknown>` causes `AvoidAdditionalProperties` and `PropertiesTypeObjectNoDefinition`

The use of `Record<unknown>` in TypeSpec is discouraged, and there is a TypeSpec lint rule to enforce this. If you still need to use `Record<unknown>`, the OpenAPI spec generated will cause many LintDiff errors of types `AvoidAdditionalProperties` and `PropertiesTypeObjectNoDefinition`. You will need to suppress both the TypeSpec violation (in TypeSpec source code) and the LintDiff violations.

### `RequestBodyMustExistForPutPatch`

We believe this is a false positive: https://github.com/Azure/azure-openapi-validator/issues/641

### `PatchPropertiesCorrespondToPutProperties`

We believe this is a false positive: https://github.com/Azure/azure-openapi-validator/issues/642

### `@singleton` causes `EvenSegmentedPathForPutOperation` and `XmsPageableForListCalls`

If `EvenSegmentedPathForPutOperation` and/or `XmsPageableForListCalls` are failing for OpenAPI generated from TypeSpec using `@singleton` (OpenAPI path ends with `/default`), we believe this is a false positive: https://github.com/Azure/azure-openapi-validator/issues/646

### `AvoidAnonymousParameter`, `AvoidAnonymousTypes`, `IntegerTypeMustHaveFormat`

Data-plane specs can suppress violations of the following rules, since they only exist for the benefit of SDKs generated from swagger, and data-plane SDKs are generated directly from TypeSpec. Resource-manager specs should **not** suppress violations of these rules, since resource-manager SDKs are generated from OpenAPI, and rely on these errors being fixed.

- `AvoidAnonymousParameter`
- `AvoidAnonymousTypes`
- `IntegerTypeMustHaveFormat`

### `AvoidAnonymousTypes` inside a 202 response

As an exception to the previous note, resource-manager specs **may** be able to suppress `AvoidAnonymousTypes`, but only if the error is inside a 202 response from a long-running operation (LRO). It is known that SDKs do not need to generate type names for such responses.

### `OAuth2Auth` causes `XmsEnumValidation`

TypeSpec using `OAuth2Auth` may generate the following OpenAPI:

``` yaml
"type": {
"type": "string",
"description": "OAuth2 authentication",
"enum": [
"oauth2"
]
},
```

Which causes error `XmsEnumValidation`. The recommended workaround is to add `omit-unreachable-types: true` to your `tspconfig.yaml`.
https://github.com/Azure/azure-rest-api-specs/wiki/Swagger-LintDiff-for-TypeSpec

## `Swagger ModelValidation`

Expand Down Expand Up @@ -324,26 +280,7 @@ If you need more information on see [cspell configuration](https://cspell.org/co

## `TypeSpec Validation`

This validator will help ensure your TypeSpec project follows [standard conventions](https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/typespec-structure-guidelines.md) as well ensures that the [generated OpenAPI spec](https://azure.github.io/typespec-azure/docs/emitters/typespec-autorest) files are in-sync with your project.

### Run `tsv` locally

``` powershell
cd <repo>
git checkout <your-branch>
git merge <target-branch>
npm ci
npx tsv <path-to-your-spec>
git commit; git push (if any changes)

# example
npx tsv specification/contosowidgetmanager/Contoso.WidgetManager
```

Then check any errors that might be outputted and address any issues as needed. If there are changed files after the runit generally means
that the generated OpenAPI spec files were not in-sync with the TypeSpec project and you should include those changes in your pull request as well.

If none of the above helped, please reach out on [TypeSpec Discussions Teams channel].
https://github.com/Azure/azure-rest-api-specs/wiki/TypeSpec-Validation

## `license/cla`

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,11 +19,6 @@
// az rest --resource <client-id> -u "{URL}" --output-file {FILENAME}
"type": "boolean"
},
"downloadUrlPrefix": {
// All the artifacts will be uploaded and user could access the artifact via
// a link composed by this prefix and artifact filename.
"type": "string"
},
"downloadCommandTemplate": {
// Download command template. Replace {URL} and {FILENAME} to get the real command.
"type": "string"
Expand Down
Loading