{ "swagger": "2.0", "info": { "title": "Microsoft Defender for Cloud", "description": "API spec for Microsoft.Security (Microsoft Defender for Cloud) resource provider", "version": "2018-06-01" }, "host": "management.azure.com", "schemes": [ "https" ], "consumes": [ "application/json" ], "produces": [ "application/json" ], "security": [ { "azure_auth": [ "user_impersonation" ] } ], "securityDefinitions": { "azure_auth": { "type": "oauth2", "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", "flow": "implicit", "description": "Azure Active Directory OAuth2 Flow", "scopes": { "user_impersonation": "impersonate your user account" } } }, "paths": { "/subscriptions/{subscriptionId}/providers/Microsoft.Security/pricings": { "get": { "x-ms-examples": { "Get pricings on subscription": { "$ref": "./examples/Pricings/ListPricings_example.json" } }, "tags": [ "Pricings" ], "description": "Lists Microsoft Defender for Cloud pricing configurations in the subscription.", "operationId": "Pricings_List", "parameters": [ { "$ref": "../../../common/v1/types.json#/parameters/ApiVersion" }, { "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PricingList" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../common/v1/types.json#/definitions/CloudError" } } } } }, "/subscriptions/{subscriptionId}/providers/Microsoft.Security/pricings/{pricingName}": { "get": { "x-ms-examples": { "Get pricings on subscription": { "$ref": "./examples/Pricings/GetPricingByName_example.json" } }, "tags": [ "Pricings" ], "description": "Gets a provided Microsoft Defender for Cloud pricing configuration in the subscription.", "operationId": "Pricings_Get", "parameters": [ { "$ref": "../../../common/v1/types.json#/parameters/ApiVersion" }, { "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId" }, { "$ref": "#/parameters/PricingName" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/Pricing" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../common/v1/types.json#/definitions/CloudError" } } } }, "put": { "x-ms-examples": { "Update pricing on subscription": { "$ref": "./examples/Pricings/PutPricingByName_example.json" } }, "tags": [ "Pricings" ], "description": "Updates a provided Microsoft Defender for Cloud pricing configuration in the subscription.", "operationId": "Pricings_Update", "parameters": [ { "$ref": "../../../common/v1/types.json#/parameters/ApiVersion" }, { "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId" }, { "$ref": "#/parameters/PricingName" }, { "$ref": "#/parameters/Pricing" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/Pricing" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../common/v1/types.json#/definitions/CloudError" } } } } } }, "definitions": { "PricingList": { "description": "List of pricing configurations response.", "required": [ "value" ], "properties": { "value": { "type": "array", "description": "List of pricing configurations", "items": { "$ref": "#/definitions/Pricing" } } } }, "Pricing": { "type": "object", "description": "Microsoft Defender for Cloud is provided in two pricing tiers: free and standard, with the standard tier available with a trial period. The standard tier offers advanced security capabilities, while the free tier offers basic security features.", "properties": { "properties": { "x-ms-client-flatten": true, "description": "Pricing data", "$ref": "#/definitions/PricingProperties" } }, "allOf": [ { "$ref": "../../../common/v1/types.json#/definitions/Resource" } ] }, "PricingProperties": { "type": "object", "description": "Pricing properties for the relevant scope", "properties": { "pricingTier": { "type": "string", "description": "The pricing tier value. Microsoft Defender for Cloud is provided in two pricing tiers: free and standard, with the standard tier available with a trial period. The standard tier offers advanced security capabilities, while the free tier offers basic security features.", "enum": [ "Free", "Standard" ], "x-ms-enum": { "name": "pricingTier", "modelAsString": true, "values": [ { "value": "Free", "description": "Get free Microsoft Defender for Cloud experience with basic security features" }, { "value": "Standard", "description": "Get the standard Microsoft Defender for Cloud experience with advanced security features" } ] } }, "freeTrialRemainingTime": { "type": "string", "format": "duration", "readOnly": true, "description": "The duration left for the subscriptions free trial period - in ISO 8601 format (e.g. P3Y6M4DT12H30M5S)." } }, "required": [ "pricingTier" ] } }, "parameters": { "PricingName": { "name": "pricingName", "in": "path", "required": true, "type": "string", "description": "name of the pricing configuration", "x-ms-parameter-location": "method" }, "Pricing": { "name": "pricing", "in": "body", "required": true, "description": "Pricing object", "schema": { "$ref": "#/definitions/Pricing" }, "x-ms-parameter-location": "method" } } }