Skip to content

Commit 308c908

Browse files
AvishalomJms-zhenhua
authored and
harryli0108
committed
[Hub Generated] Publish private branch 'avjan/new-api-version-for-vasetteings' (Azure#24251)
* Added stable api version for ServerVulnerabilityAssessmentsSettings * Update system data ref and readme's api-version * Update ServerVulnerabilityAssessmentsSetting's definition ref * Updated ServerVulnerabilityAssessmentsSetting's systemData property * Updated ServerVulnerabilityAssessmentsSetting ref to proxyResource * Revert "Updated ServerVulnerabilityAssessmentsSetting ref to proxyResource" This reverts commit f5b7b44. * Update specification/security/resource-manager/Microsoft.Security/stable/2023-05-01/ServerVulnerabilityAssessmentsSettings.json Co-authored-by: Zhenhua Hu <[email protected]> * Update ServerVulnerabilityAssessmentsSettings.json - minor changes * Update ServerVulnerabilityAssessmentsSettings.json - Added 200 ok response for put request * Updated ServerVulnerabilityAssessmentsSetting's references to the latest - v5 * Update PutServerVulnerabilityAssessmentsSetting_example.json added 200 ok response --------- Co-authored-by: Zhenhua Hu <[email protected]>
1 parent 88f23d6 commit 308c908

File tree

6 files changed

+463
-0
lines changed

6 files changed

+463
-0
lines changed

‎specification/security/resource-manager/Microsoft.Security/stable/2023-05-01/ServerVulnerabilityAssessmentsSettings.json

Lines changed: 330 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,330 @@
1+
{
2+
"swagger": "2.0",
3+
"info": {
4+
"title": "Security Center",
5+
"description": "API spec for Microsoft.Security (Azure Security Center) resource provider",
6+
"version": "2023-05-01"
7+
},
8+
"host": "management.azure.com",
9+
"schemes": [
10+
"https"
11+
],
12+
"consumes": [
13+
"application/json"
14+
],
15+
"produces": [
16+
"application/json"
17+
],
18+
"security": [
19+
{
20+
"azure_auth": [
21+
"user_impersonation"
22+
]
23+
}
24+
],
25+
"securityDefinitions": {
26+
"azure_auth": {
27+
"type": "oauth2",
28+
"authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
29+
"flow": "implicit",
30+
"description": "Azure Active Directory OAuth2 Flow",
31+
"scopes": {
32+
"user_impersonation": "impersonate your user account"
33+
}
34+
}
35+
},
36+
"paths": {
37+
"/subscriptions/{subscriptionId}/providers/Microsoft.Security/serverVulnerabilityAssessmentsSettings": {
38+
"get": {
39+
"x-ms-examples": {
40+
"List the server vulnerability assessments settings set on the subscription": {
41+
"$ref": "./examples/ServerVulnerabilityAssessmentsSettings/ListServerVulnerabilityAssessmentsSettings_example.json"
42+
}
43+
},
44+
"tags": [
45+
"ServerVulnerabilityAssessmentsSettings"
46+
],
47+
"description": "Get a list of all the server vulnerability assessments settings over a subscription level scope",
48+
"operationId": "ServerVulnerabilityAssessmentsSettings_ListBySubscription",
49+
"parameters": [
50+
{
51+
"$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter"
52+
},
53+
{
54+
"$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter"
55+
}
56+
],
57+
"responses": {
58+
"200": {
59+
"description": "OK",
60+
"schema": {
61+
"$ref": "#/definitions/ServerVulnerabilityAssessmentsSettingsList"
62+
}
63+
},
64+
"default": {
65+
"description": "Error response describing why the operation failed",
66+
"schema": {
67+
"$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse"
68+
}
69+
}
70+
},
71+
"x-ms-pageable": {
72+
"nextLinkName": "nextLink"
73+
}
74+
}
75+
},
76+
"/subscriptions/{subscriptionId}/providers/Microsoft.Security/serverVulnerabilityAssessmentsSettings/{settingKind}": {
77+
"get": {
78+
"x-ms-examples": {
79+
"Get the server vulnerability assessments setting of the kind settingKind that is set on the subscription": {
80+
"$ref": "./examples/ServerVulnerabilityAssessmentsSettings/GetServerVulnerabilityAssessmentsSetting_example.json"
81+
}
82+
},
83+
"tags": [
84+
"ServerVulnerabilityAssessmentsSettings"
85+
],
86+
"description": "Get a server vulnerability assessments setting of the requested kind, that is set on the subscription",
87+
"operationId": "ServerVulnerabilityAssessmentsSettings_Get",
88+
"parameters": [
89+
{
90+
"$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter"
91+
},
92+
{
93+
"$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter"
94+
},
95+
{
96+
"$ref": "#/parameters/SettingKind"
97+
}
98+
],
99+
"responses": {
100+
"200": {
101+
"description": "OK",
102+
"schema": {
103+
"$ref": "#/definitions/ServerVulnerabilityAssessmentsSetting"
104+
}
105+
},
106+
"default": {
107+
"description": "Error response describing why the operation failed",
108+
"schema": {
109+
"$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse"
110+
}
111+
}
112+
}
113+
},
114+
"put": {
115+
"x-ms-examples": {
116+
"Set a server vulnerability assessments setting of the kind settingKind on the subscription": {
117+
"$ref": "./examples/ServerVulnerabilityAssessmentsSettings/PutServerVulnerabilityAssessmentsSetting_example.json"
118+
}
119+
},
120+
"tags": [
121+
"ServerVulnerabilityAssessmentsSettings"
122+
],
123+
"description": "Create or update a server vulnerability assessments setting of the requested kind on the subscription",
124+
"operationId": "ServerVulnerabilityAssessmentsSettings_CreateOrUpdate",
125+
"parameters": [
126+
{
127+
"$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter"
128+
},
129+
{
130+
"$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter"
131+
},
132+
{
133+
"$ref": "#/parameters/SettingKind"
134+
},
135+
{
136+
"$ref": "#/parameters/SettingBody"
137+
}
138+
],
139+
"responses": {
140+
"200": {
141+
"description": "OK",
142+
"schema": {
143+
"$ref": "#/definitions/ServerVulnerabilityAssessmentsSetting"
144+
}
145+
},
146+
"201": {
147+
"description": "Created",
148+
"schema": {
149+
"$ref": "#/definitions/ServerVulnerabilityAssessmentsSetting"
150+
}
151+
},
152+
"default": {
153+
"description": "Error response describing why the operation failed",
154+
"schema": {
155+
"$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse"
156+
}
157+
}
158+
}
159+
},
160+
"delete": {
161+
"x-ms-examples": {
162+
"Delete the server vulnerability assessments setting of the kind settingKind from the subscription": {
163+
"$ref": "./examples/ServerVulnerabilityAssessmentsSettings/DeleteServerVulnerabilityAssessmentsSetting_example.json"
164+
}
165+
},
166+
"tags": [
167+
"ServerVulnerabilityAssessmentsSettings"
168+
],
169+
"description": "Delete the server vulnerability assessments setting of the requested kind from the subscription",
170+
"operationId": "ServerVulnerabilityAssessmentsSettings_Delete",
171+
"parameters": [
172+
{
173+
"$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter"
174+
},
175+
{
176+
"$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter"
177+
},
178+
{
179+
"$ref": "#/parameters/SettingKind"
180+
}
181+
],
182+
"responses": {
183+
"200": {
184+
"description": "OK - Setting was deleted"
185+
},
186+
"204": {
187+
"description": "No Content - Setting does not exist"
188+
},
189+
"default": {
190+
"description": "Error response describing why the operation failed",
191+
"schema": {
192+
"$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse"
193+
}
194+
}
195+
}
196+
}
197+
}
198+
},
199+
"definitions": {
200+
"ServerVulnerabilityAssessmentsSettingsList": {
201+
"type": "object",
202+
"description": "A page of a server vulnerability assessments settings list",
203+
"properties": {
204+
"value": {
205+
"description": "A collection of server vulnerability assessments settings in this page",
206+
"readOnly": true,
207+
"type": "array",
208+
"items": {
209+
"$ref": "#/definitions/ServerVulnerabilityAssessmentsSetting"
210+
}
211+
},
212+
"nextLink": {
213+
"readOnly": true,
214+
"type": "string",
215+
"description": "The URI to fetch the next page"
216+
}
217+
}
218+
},
219+
"ServerVulnerabilityAssessmentsSetting": {
220+
"type": "object",
221+
"description": "A base vulnerability assessments setting on servers in the defined scope.",
222+
"properties": {
223+
"kind": {
224+
"description": "The kind of the server vulnerability assessments setting.",
225+
"$ref": "#/definitions/ServerVulnerabilityAssessmentsSettingKind"
226+
}
227+
},
228+
"discriminator": "kind",
229+
"required": [
230+
"kind"
231+
],
232+
"allOf": [
233+
{
234+
"$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/Resource"
235+
}
236+
]
237+
},
238+
"AzureServersSetting": {
239+
"type": "object",
240+
"description": "A vulnerability assessments setting on Azure servers in the defined scope.",
241+
"properties": {
242+
"properties": {
243+
"x-ms-client-flatten": true,
244+
"description": "The vulnerability assessments setting properties on Azure servers in the defined scope.",
245+
"$ref": "#/definitions/ServerVulnerabilityAssessmentsAzureSettingProperties"
246+
}
247+
},
248+
"allOf": [
249+
{
250+
"$ref": "#/definitions/ServerVulnerabilityAssessmentsSetting"
251+
}
252+
],
253+
"x-ms-discriminator-value": "AzureServersSetting"
254+
},
255+
"ServerVulnerabilityAssessmentsAzureSettingProperties": {
256+
"type": "object",
257+
"description": "Describes the vulnerability assessments setting properties on Azure servers in the defined scope.",
258+
"properties": {
259+
"selectedProvider": {
260+
"description": "The selected vulnerability assessments provider on Azure servers in the defined scope.",
261+
"type": "string",
262+
"enum": [
263+
"MdeTvm"
264+
],
265+
"x-ms-enum": {
266+
"name": "ServerVulnerabilityAssessmentsAzureSettingSelectedProvider",
267+
"modelAsString": true,
268+
"values": [
269+
{
270+
"description": "Microsoft Defender for Endpoints threat and vulnerability management.",
271+
"value": "MdeTvm"
272+
}
273+
]
274+
}
275+
}
276+
},
277+
"required": [
278+
"selectedProvider"
279+
]
280+
},
281+
"ServerVulnerabilityAssessmentsSettingKind": {
282+
"type": "string",
283+
"description": "The kind of the server vulnerability assessments setting",
284+
"enum": [
285+
"AzureServersSetting"
286+
],
287+
"x-ms-enum": {
288+
"name": "ServerVulnerabilityAssessmentsSettingKind",
289+
"modelAsString": true,
290+
"values": [
291+
{
292+
"value": "AzureServersSetting"
293+
}
294+
]
295+
}
296+
}
297+
},
298+
"parameters": {
299+
"SettingKind": {
300+
"name": "settingKind",
301+
"in": "path",
302+
"required": true,
303+
"type": "string",
304+
"description": "The kind of the server vulnerability assessments setting",
305+
"enum": [
306+
"azureServersSetting"
307+
],
308+
"x-ms-enum": {
309+
"name": "ServerVulnerabilityAssessmentsSettingKindName",
310+
"modelAsString": true,
311+
"values": [
312+
{
313+
"value": "azureServersSetting"
314+
}
315+
]
316+
},
317+
"x-ms-parameter-location": "method"
318+
},
319+
"SettingBody": {
320+
"name": "serverVulnerabilityAssessmentsSetting",
321+
"in": "body",
322+
"required": true,
323+
"schema": {
324+
"$ref": "#/definitions/ServerVulnerabilityAssessmentsSetting"
325+
},
326+
"description": "A server vulnerability assessments setting over a predefined scope",
327+
"x-ms-parameter-location": "method"
328+
}
329+
}
330+
}

‎specification/security/resource-manager/Microsoft.Security/stable/2023-05-01/examples/ServerVulnerabilityAssessmentsSettings/DeleteServerVulnerabilityAssessmentsSetting_example.json

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"parameters": {
3+
"api-version": "2023-05-01",
4+
"subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
5+
"settingKind": "azureServersSetting"
6+
},
7+
"responses": {
8+
"200": {},
9+
"204": {}
10+
}
11+
}

‎specification/security/resource-manager/Microsoft.Security/stable/2023-05-01/examples/ServerVulnerabilityAssessmentsSettings/GetServerVulnerabilityAssessmentsSetting_example.json

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
{
2+
"parameters": {
3+
"api-version": "2023-05-01",
4+
"subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
5+
"settingKind": "azureServersSetting"
6+
},
7+
"responses": {
8+
"200": {
9+
"body": {
10+
"id": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/serverVulnerabilityAssessmentsSettings/azureServersSetting",
11+
"name": "azureServersSetting",
12+
"type": "Microsoft.Security/serverVulnerabilityAssessmentsSettings",
13+
"kind": "AzureServersSetting",
14+
"properties": {
15+
"selectedProvider": "MdeTvm"
16+
},
17+
"systemData": {
18+
"createdBy": "[email protected]",
19+
"createdByType": "User",
20+
"createdAt": "2023-05-12T13:47:50.328Z",
21+
"lastModifiedBy": "[email protected]",
22+
"lastModifiedByType": "User",
23+
"lastModifiedAt": "2023-05-12T13:47:50.328Z"
24+
}
25+
}
26+
}
27+
}
28+
}

0 commit comments

Comments
 (0)