{ "swagger": "2.0", "info": { "title": "ApplicationInsightsManagementClient", "description": "Azure Application Insights workbook type.", "version": "2015-05-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}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/workbooks": { "get": { "description": "Get all Workbooks defined within a specified resource group and category.", "operationId": "Workbooks_ListByResourceGroup", "parameters": [ { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter" }, { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "#/parameters/CategoryParameter" }, { "$ref": "#/parameters/TagsParameter" }, { "$ref": "#/parameters/CanFetchWorkbookContentParameter" }, { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter" } ], "responses": { "200": { "description": "A list containing 0 or more workbook definitions.", "schema": { "$ref": "#/definitions/WorkbooksListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/WorkbookError" } } }, "x-ms-pageable": { "nextLinkName": null }, "x-ms-examples": { "WorkbooksList": { "$ref": "./examples/WorkbooksList.json" } } } }, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/workbooks/{resourceName}": { "get": { "description": "Get a single workbook by its resourceName.", "operationId": "Workbooks_Get", "parameters": [ { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter" }, { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "#/parameters/WorkbookResourceNameParameter" }, { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter" } ], "responses": { "200": { "description": "A workbook definition.", "schema": { "$ref": "#/definitions/Workbook" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/WorkbookError" } } }, "x-ms-examples": { "WorkbookGet": { "$ref": "./examples/WorkbookGet.json" } } }, "delete": { "description": "Delete a workbook.", "operationId": "Workbooks_Delete", "parameters": [ { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter" }, { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "#/parameters/WorkbookResourceNameParameter" }, { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter" } ], "responses": { "201": { "description": "The workbook has been successfully deleted." }, "204": { "description": "The resource doesn't exist." }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/WorkbookError" } } }, "x-ms-examples": { "WorkbookDelete": { "$ref": "./examples/WorkbookDelete.json" } } }, "put": { "description": "Create a new workbook.", "operationId": "Workbooks_CreateOrUpdate", "parameters": [ { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter" }, { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "#/parameters/WorkbookResourceNameParameter" }, { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter" }, { "name": "workbookProperties", "description": "Properties that need to be specified to create a new workbook.", "in": "body", "required": true, "schema": { "$ref": "#/definitions/Workbook" } } ], "responses": { "200": { "description": "The newly created workbook.", "schema": { "$ref": "#/definitions/Workbook" } }, "201": { "description": "The newly created workbook.", "schema": { "$ref": "#/definitions/Workbook" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/WorkbookError" } } }, "x-ms-examples": { "WorkbookAdd": { "$ref": "./examples/WorkbookAdd.json" } } }, "patch": { "description": "Updates a workbook that has already been added.", "operationId": "Workbooks_Update", "parameters": [ { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter" }, { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "#/parameters/WorkbookResourceNameParameter" }, { "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter" }, { "name": "workbookProperties", "description": "Properties that need to be specified to create a new workbook.", "in": "body", "required": true, "schema": { "$ref": "#/definitions/Workbook" } } ], "responses": { "200": { "description": "The workbook definition updated.", "schema": { "$ref": "#/definitions/Workbook" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/WorkbookError" } } }, "x-ms-examples": { "WorkbookUpdate": { "$ref": "./examples/WorkbookUpdate.json" } } } } }, "definitions": { "WorkbookResource": { "properties": { "id": { "type": "string", "readOnly": true, "description": "Azure resource Id" }, "name": { "type": "string", "description": "Azure resource name", "readOnly": true }, "type": { "type": "string", "readOnly": true, "description": "Azure resource type" }, "location": { "type": "string", "description": "Resource location", "x-ms-mutability": [ "create", "read" ] }, "tags": { "additionalProperties": { "type": "string" }, "description": "Resource tags" } }, "x-ms-azure-resource": true, "description": "An azure resource object" }, "WorkbooksListResult": { "properties": { "value": { "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/Workbook" }, "description": "An array of workbooks." } }, "description": "Workbook list result." }, "Workbook": { "description": "An Application Insights workbook definition.", "allOf": [ { "$ref": "#/definitions/WorkbookResource" } ], "properties": { "kind": { "type": "string", "description": "The kind of workbook. Choices are user and shared.", "enum": [ "user", "shared" ], "x-ms-enum": { "name": "SharedTypeKind", "modelAsString": true } }, "properties": { "x-ms-client-flatten": true, "description": "Metadata describing a web test for an Azure resource.", "$ref": "#/definitions/WorkbookProperties" } } }, "LinkProperties": { "description": "Contains a sourceId and workbook resource id to link two resources.", "properties": { "sourceId": { "type": "string", "description": "The source Azure resource id" }, "targetId": { "type": "string", "description": "The workbook Azure resource id" }, "category": { "type": "string", "description": "The category of workbook" } } }, "WorkbookProperties": { "description": "Properties that contain a workbook.", "required": [ "name", "kind", "category", "workbookId", "serializedData", "userId" ], "properties": { "name": { "type": "string", "description": "The user-defined name of the workbook." }, "serializedData": { "type": "string", "description": "Configuration of this particular workbook. Configuration data is a string containing valid JSON" }, "version": { "type": "string", "description": "This instance's version of the data model. This can change as new features are added that can be marked workbook." }, "workbookId": { "type": "string", "description": "Internally assigned unique id of the workbook definition." }, "kind": { "description": "Enum indicating if this workbook definition is owned by a specific user or is shared between all users with access to the Application Insights component.", "x-ms-client-name": "SharedTypeKind", "default": "shared", "type": "string", "enum": [ "shared", "user" ], "x-ms-enum": { "name": "SharedTypeKind", "modelAsString": true } }, "timeModified": { "type": "string", "description": "Date and time in UTC of the last modification that was made to this workbook definition.", "readOnly": true }, "category": { "type": "string", "description": "Workbook category, as defined by the user at creation time." }, "tags": { "type": "array", "items": { "type": "string" }, "description": "A list of 0 or more tags that are associated with this workbook definition" }, "userId": { "type": "string", "description": "Unique user id of the specific user that owns this workbook." }, "sourceResourceId": { "type": "string", "description": "Optional resourceId for a source resource." } } }, "ErrorFieldContract": { "properties": { "code": { "type": "string", "description": "Property level error code." }, "message": { "type": "string", "description": "Human-readable representation of property-level error." }, "target": { "type": "string", "description": "Property name." } }, "description": "Error Field contract." }, "WorkbookError": { "properties": { "code": { "type": "string", "description": "Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response." }, "message": { "type": "string", "description": "Human-readable representation of the error." }, "details": { "type": "array", "items": { "$ref": "#/definitions/ErrorFieldContract" }, "description": "The list of invalid fields send in request, in case of validation error." } }, "description": "Error message body that will indicate why the operation failed." } }, "parameters": { "WorkbookResourceNameParameter": { "name": "resourceName", "in": "path", "required": true, "type": "string", "description": "The name of the Application Insights component resource.", "x-ms-parameter-location": "method" }, "CategoryParameter": { "name": "category", "in": "query", "required": true, "type": "string", "enum": [ "workbook", "TSG", "performance", "retention" ], "x-ms-enum": { "name": "CategoryType", "modelAsString": true }, "description": "Category of workbook to return.", "x-ms-parameter-location": "method" }, "SourceIdParameter": { "name": "sourceId", "in": "query", "required": true, "type": "string", "description": "Azure Resource Id that will fetch all linked workbooks.", "x-ms-parameter-location": "method" }, "ResourceIdParameter": { "name": "resourceId", "in": "query", "required": true, "type": "string", "description": "Azure Resource Id or any target workbook resource id.", "x-ms-parameter-location": "method" }, "CanFetchWorkbookContentParameter": { "name": "canFetchContent", "in": "query", "required": false, "type": "boolean", "description": "Flag indicating whether or not to return the full content for each applicable workbook. If false, only return summary content for workbooks.", "x-ms-parameter-location": "method" }, "TagsParameter": { "name": "tags", "in": "query", "required": false, "type": "array", "items": { "type": "string" }, "collectionFormat": "csv", "description": "Tags presents on each workbook returned.", "x-ms-parameter-location": "method" } } }