{ "swagger": "2.0", "info": { "title": "ApiManagementClient", "description": "Use these REST APIs for performing operations on Diagnostic entity associated with your Azure API Management deployment. Diagnostics are used to log requests/responses in the API Management proxy.", "version": "2024-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.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/diagnostics": { "get": { "tags": [ "Diagnostic" ], "operationId": "WorkspaceDiagnostic_ListByWorkspace", "description": "Lists all diagnostics in the specified workspace.", "x-ms-examples": { "ApiManagementListWorkspaceDiagnostics": { "$ref": "./examples/ApiManagementListWorkspaceDiagnostics.json" } }, "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "./apimanagement.json#/parameters/ServiceNameParameter" }, { "$ref": "./apimanagement.json#/parameters/WorkspaceIdParameter" }, { "name": "$filter", "in": "query", "required": false, "type": "string", "description": "| Field | Usage | Supported operators | Supported functions |
|-------------|-------------|-------------|-------------|
| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |
" }, { "$ref": "./apimanagement.json#/parameters/TopQueryParameter" }, { "$ref": "./apimanagement.json#/parameters/SkipQueryParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" } ], "responses": { "200": { "description": "Paged Result response of diagnostics.", "schema": { "$ref": "./definitions.json#/definitions/DiagnosticCollection" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" }, "x-ms-odata": "./definitions.json#/definitions/DiagnosticContract" } }, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/diagnostics/{diagnosticId}": { "head": { "tags": [ "Diagnostic" ], "operationId": "WorkspaceDiagnostic_GetEntityTag", "description": "Gets the entity state (Etag) version of the Diagnostic specified by its identifier.", "x-ms-examples": { "ApiManagementHeadWorkspaceDiagnostic": { "$ref": "./examples/ApiManagementHeadWorkspaceDiagnostic.json" } }, "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "./apimanagement.json#/parameters/ServiceNameParameter" }, { "$ref": "./apimanagement.json#/parameters/WorkspaceIdParameter" }, { "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" } ], "responses": { "200": { "description": "Gets the entity tag of the diagnostic", "headers": { "ETag": { "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.", "type": "string" } } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" } } } }, "get": { "tags": [ "Diagnostic" ], "operationId": "WorkspaceDiagnostic_Get", "description": "Gets the details of the Diagnostic specified by its identifier.", "x-ms-examples": { "ApiManagementGetWorkspaceDiagnostic": { "$ref": "./examples/ApiManagementGetWorkspaceDiagnostic.json" } }, "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "./apimanagement.json#/parameters/ServiceNameParameter" }, { "$ref": "./apimanagement.json#/parameters/WorkspaceIdParameter" }, { "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" } ], "responses": { "200": { "description": "The response body contains the specified Diagnostic entity.", "headers": { "ETag": { "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.", "type": "string" } }, "schema": { "$ref": "./definitions.json#/definitions/DiagnosticContract" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" } } } }, "put": { "tags": [ "Diagnostic" ], "operationId": "WorkspaceDiagnostic_CreateOrUpdate", "description": "Creates a new Diagnostic or updates an existing one.", "x-ms-examples": { "ApiManagementCreateWorkspaceDiagnostic": { "$ref": "./examples/ApiManagementCreateWorkspaceDiagnostic.json" } }, "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "./apimanagement.json#/parameters/ServiceNameParameter" }, { "$ref": "./apimanagement.json#/parameters/WorkspaceIdParameter" }, { "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "./definitions.json#/definitions/DiagnosticContract" }, "description": "Create parameters." }, { "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" } ], "responses": { "201": { "description": "Diagnostic was successfully created.", "headers": { "ETag": { "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.", "type": "string" } }, "schema": { "$ref": "./definitions.json#/definitions/DiagnosticContract" } }, "200": { "description": "Diagnostic successfully updated", "headers": { "ETag": { "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.", "type": "string" } }, "schema": { "$ref": "./definitions.json#/definitions/DiagnosticContract" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" } } } }, "patch": { "tags": [ "Diagnostic" ], "operationId": "WorkspaceDiagnostic_Update", "description": "Updates the details of the Diagnostic specified by its identifier.", "x-ms-examples": { "ApiManagementUpdateWorkspaceDiagnostic": { "$ref": "./examples/ApiManagementUpdateWorkspaceDiagnostic.json" } }, "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "./apimanagement.json#/parameters/ServiceNameParameter" }, { "$ref": "./apimanagement.json#/parameters/WorkspaceIdParameter" }, { "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "./definitions.json#/definitions/DiagnosticUpdateContract" }, "description": "Diagnostic Update parameters." }, { "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" } ], "responses": { "200": { "description": "Diagnostic successfully updated", "schema": { "$ref": "./definitions.json#/definitions/DiagnosticContract" }, "headers": { "ETag": { "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.", "type": "string" } } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" } } } }, "delete": { "tags": [ "Diagnostic" ], "operationId": "WorkspaceDiagnostic_Delete", "description": "Deletes the specified Diagnostic.", "x-ms-examples": { "ApiManagementDeleteWorkspaceDiagnostic": { "$ref": "./examples/ApiManagementDeleteWorkspaceDiagnostic.json" } }, "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "./apimanagement.json#/parameters/ServiceNameParameter" }, { "$ref": "./apimanagement.json#/parameters/WorkspaceIdParameter" }, { "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter" }, { "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" } ], "responses": { "200": { "description": "The Diagnostic was successfully deleted." }, "204": { "description": "The Diagnostic was successfully deleted." }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" } } } } }, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis/{apiId}/diagnostics": { "get": { "tags": [ "ApiDiagnostic" ], "operationId": "WorkspaceApiDiagnostic_ListByWorkspace", "description": "Lists all diagnostics of an API.", "x-ms-examples": { "ApiManagementListWorkspaceApiDiagnostics": { "$ref": "./examples/ApiManagementListWorkspaceApiDiagnostics.json" } }, "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "./apimanagement.json#/parameters/ServiceNameParameter" }, { "$ref": "./apimanagement.json#/parameters/WorkspaceIdParameter" }, { "$ref": "./apimanagement.json#/parameters/ApiIdParameter" }, { "name": "$filter", "in": "query", "required": false, "type": "string", "description": "| Field | Usage | Supported operators | Supported functions |
|-------------|-------------|-------------|-------------|
| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |
" }, { "$ref": "./apimanagement.json#/parameters/TopQueryParameter" }, { "$ref": "./apimanagement.json#/parameters/SkipQueryParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" } ], "responses": { "200": { "description": "Paged Result response of diagnostics for an API.", "schema": { "$ref": "./definitions.json#/definitions/DiagnosticCollection" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" }, "x-ms-odata": "./definitions.json#/definitions/DiagnosticContract" } }, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis/{apiId}/diagnostics/{diagnosticId}": { "head": { "tags": [ "ApiDiagnostic" ], "operationId": "WorkspaceApiDiagnostic_GetEntityTag", "description": "Gets the entity state (Etag) version of the Diagnostic for an API specified by its identifier.", "x-ms-examples": { "ApiManagementHeadWorkspaceApiDiagnostic": { "$ref": "./examples/ApiManagementHeadWorkspaceApiDiagnostic.json" } }, "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "./apimanagement.json#/parameters/ServiceNameParameter" }, { "$ref": "./apimanagement.json#/parameters/WorkspaceIdParameter" }, { "$ref": "./apimanagement.json#/parameters/ApiIdParameter" }, { "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" } ], "responses": { "200": { "description": "Operation completed successfully.", "headers": { "ETag": { "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.", "type": "string" } } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" } } } }, "get": { "tags": [ "ApiDiagnostic" ], "operationId": "WorkspaceApiDiagnostic_Get", "description": "Gets the details of the Diagnostic for an API specified by its identifier.", "x-ms-examples": { "ApiManagementGetWorkspaceApiDiagnostic": { "$ref": "./examples/ApiManagementGetWorkspaceApiDiagnostic.json" } }, "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "./apimanagement.json#/parameters/ServiceNameParameter" }, { "$ref": "./apimanagement.json#/parameters/WorkspaceIdParameter" }, { "$ref": "./apimanagement.json#/parameters/ApiIdParameter" }, { "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" } ], "responses": { "200": { "description": "The response body contains the specified Diagnostic entity.", "schema": { "$ref": "./definitions.json#/definitions/DiagnosticContract" }, "headers": { "ETag": { "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.", "type": "string" } } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" } } } }, "put": { "tags": [ "ApiDiagnostic" ], "operationId": "WorkspaceApiDiagnostic_CreateOrUpdate", "description": "Creates a new Diagnostic for an API or updates an existing one.", "x-ms-examples": { "ApiManagementCreateWorkspaceApiDiagnostic": { "$ref": "./examples/ApiManagementCreateWorkspaceApiDiagnostic.json" } }, "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "./apimanagement.json#/parameters/ServiceNameParameter" }, { "$ref": "./apimanagement.json#/parameters/WorkspaceIdParameter" }, { "$ref": "./apimanagement.json#/parameters/ApiIdParameter" }, { "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "./definitions.json#/definitions/DiagnosticContract" }, "description": "Create parameters." }, { "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" } ], "responses": { "201": { "description": "Diagnostic was successfully created.", "schema": { "$ref": "./definitions.json#/definitions/DiagnosticContract" }, "headers": { "ETag": { "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.", "type": "string" } } }, "200": { "description": "Diagnostic was successfully updated.", "schema": { "$ref": "./definitions.json#/definitions/DiagnosticContract" }, "headers": { "ETag": { "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.", "type": "string" } } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" } } } }, "patch": { "tags": [ "ApiDiagnostic" ], "operationId": "WorkspaceApiDiagnostic_Update", "description": "Updates the details of the Diagnostic for an API specified by its identifier.", "x-ms-examples": { "ApiManagementUpdateWorkspaceApiDiagnostic": { "$ref": "./examples/ApiManagementUpdateWorkspaceApiDiagnostic.json" } }, "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "./apimanagement.json#/parameters/ServiceNameParameter" }, { "$ref": "./apimanagement.json#/parameters/WorkspaceIdParameter" }, { "$ref": "./apimanagement.json#/parameters/ApiIdParameter" }, { "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "./definitions.json#/definitions/DiagnosticUpdateContract" }, "description": "Diagnostic Update parameters." }, { "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" } ], "responses": { "200": { "description": "Diagnostic was successfully updated.", "schema": { "$ref": "./definitions.json#/definitions/DiagnosticContract" }, "headers": { "ETag": { "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.", "type": "string" } } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" } } } }, "delete": { "tags": [ "ApiDiagnostic" ], "operationId": "WorkspaceApiDiagnostic_Delete", "description": "Deletes the specified Diagnostic from an API.", "x-ms-examples": { "ApiManagementDeleteWorkspaceApiDiagnostic": { "$ref": "./examples/ApiManagementDeleteWorkspaceApiDiagnostic.json" } }, "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "./apimanagement.json#/parameters/ServiceNameParameter" }, { "$ref": "./apimanagement.json#/parameters/WorkspaceIdParameter" }, { "$ref": "./apimanagement.json#/parameters/ApiIdParameter" }, { "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter" }, { "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" } ], "responses": { "200": { "description": "Diagnostic successfully removed" }, "204": { "description": "Diagnostic successfully removed by previous request or does not exist" }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" } } } } } }, "definitions": {}, "parameters": {} }