api_diagnostics

Creates, updates, deletes, gets or lists a api_diagnostics resource.

Overview

Name	api_diagnostics
Type	Resource
Id	azure.api_management.api_diagnostics

Fields

vw_api_diagnostics

Name	Datatype	Description
always_log	text	field from the properties object
apiId	text	field from the properties object
backend	text	field from the properties object
diagnosticId	text	field from the properties object
frontend	text	field from the properties object
http_correlation_protocol	text	field from the properties object
log_client_ip	text	field from the properties object
logger_id	text	field from the properties object
metrics	text	field from the properties object
operation_name_format	text	field from the properties object
resourceGroupName	text	field from the properties object
sampling	text	field from the properties object
serviceName	text	field from the properties object
subscriptionId	text	field from the properties object
verbosity	text	field from the properties object

api_diagnostics

Name	Datatype	Description
properties	object	Diagnostic Entity Properties

Methods

Name	Accessible by	Required Params	Description
get	SELECT	apiId, diagnosticId, resourceGroupName, serviceName, subscriptionId	Gets the details of the Diagnostic for an API specified by its identifier.
list_by_service	SELECT	apiId, resourceGroupName, serviceName, subscriptionId	Lists all diagnostics of an API.
create_or_update	INSERT	apiId, diagnosticId, resourceGroupName, serviceName, subscriptionId	Creates a new Diagnostic for an API or updates an existing one.
delete	DELETE	If-Match, apiId, diagnosticId, resourceGroupName, serviceName, subscriptionId	Deletes the specified Diagnostic from an API.
update	UPDATE	If-Match, apiId, diagnosticId, resourceGroupName, serviceName, subscriptionId	Updates the details of the Diagnostic for an API specified by its identifier.

SELECT examples

Lists all diagnostics of an API.

vw_api_diagnostics

SELECT
always_log,
apiId,
backend,
diagnosticId,
frontend,
http_correlation_protocol,
log_client_ip,
logger_id,
metrics,
operation_name_format,
resourceGroupName,
sampling,
serviceName,
subscriptionId,
verbosity
FROM azure.api_management.vw_api_diagnostics
WHERE apiId = '{{ apiId }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND serviceName = '{{ serviceName }}'
AND subscriptionId = '{{ subscriptionId }}';

api_diagnostics

SELECT
properties
FROM azure.api_management.api_diagnostics
WHERE apiId = '{{ apiId }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND serviceName = '{{ serviceName }}'
AND subscriptionId = '{{ subscriptionId }}';

INSERT example

Use the following StackQL query and manifest file to create a new api_diagnostics resource.

All Properties

/*+ create */
INSERT INTO azure.api_management.api_diagnostics (
apiId,
diagnosticId,
resourceGroupName,
serviceName,
subscriptionId,
properties
)
SELECT 
'{{ apiId }}',
'{{ diagnosticId }}',
'{{ resourceGroupName }}',
'{{ serviceName }}',
'{{ subscriptionId }}',
'{{ properties }}'
;

Manifest

- name: your_resource_model_name
  props:
    - name: properties
      value:
        - name: alwaysLog
          value: string
        - name: loggerId
          value: string
        - name: sampling
          value:
            - name: samplingType
              value: string
            - name: percentage
              value: number
        - name: frontend
          value:
            - name: request
              value:
                - name: headers
                  value:
                    - string
                - name: body
                  value:
                    - name: bytes
                      value: integer
                - name: dataMasking
                  value:
                    - name: queryParams
                      value:
                        - - name: value
                            value: string
                          - name: mode
                            value: string
                    - name: headers
                      value:
                        - - name: value
                            value: string
                          - name: mode
                            value: string
        - name: logClientIp
          value: boolean
        - name: httpCorrelationProtocol
          value: string
        - name: verbosity
          value: string
        - name: operationNameFormat
          value: string
        - name: metrics
          value: boolean

UPDATE example

Updates a api_diagnostics resource.

/*+ update */
UPDATE azure.api_management.api_diagnostics
SET 
properties = '{{ properties }}'
WHERE 
If-Match = '{{ If-Match }}'
AND apiId = '{{ apiId }}'
AND diagnosticId = '{{ diagnosticId }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND serviceName = '{{ serviceName }}'
AND subscriptionId = '{{ subscriptionId }}';

DELETE example

Deletes the specified api_diagnostics resource.

/*+ delete */
DELETE FROM azure.api_management.api_diagnostics
WHERE If-Match = '{{ If-Match }}'
AND apiId = '{{ apiId }}'
AND diagnosticId = '{{ diagnosticId }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND serviceName = '{{ serviceName }}'
AND subscriptionId = '{{ subscriptionId }}';