Subscription Diagnostic Settings - Get

Serviço:

Monitor

Versão da API:

2021-05-01-preview

Obtém as definições de diagnóstico de subscrição ativas para o recurso especificado.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Insights/diagnosticSettings/{name}?api-version=2021-05-01-preview

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
name	path	True	string	O nome da definição de diagnóstico.
subscriptionId	path	True	string	O ID da subscrição de destino.
api-version	query	True	string	A versão da API a utilizar para esta operação.

Respostas

Name	Tipo	Description
200 OK	SubscriptionDiagnosticSettingsResource	Pedido com êxito para obter mais informações sobre a definição de diagnóstico.
Other Status Codes	ErrorResponse	Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

Gets the subscription diagnostic setting

Gets the subscription diagnostic setting for category

Gets the subscription diagnostic setting

Pedido de amostra

HTTP

GET https://management.azure.com/subscriptions/fb9f25f9-5785-4510-a38f-a62f188eb9f8/providers/Microsoft.Insights/diagnosticSettings/mysetting?api-version=2021-05-01-preview

Resposta da amostra

Código de estado:

200

{
  "id": "subscriptions/fb9f25f9-5785-4510-a38f-a62f188eb9f8/providers/AzureResourceManager/diagnosticSettings/ds4",
  "type": null,
  "name": "ds4",
  "properties": {
    "storageAccountId": "/subscriptions/fb9f25f9-5785-4510-a38f-a62f188eb9f8/resourceGroups/apptest/providers/Microsoft.Storage/storageAccounts/appteststorage1",
    "workspaceId": "/subscriptions/fb9f25f9-5785-4510-a38f-a62f188eb9f8/resourceGroups/apptest/providers/Microsoft.OperationalInsights/workspaces/test1",
    "eventHubAuthorizationRuleId": "/subscriptions/fb9f25f9-5785-4510-a38f-a62f188eb9f8/resourceGroups/apptest/providers/microsoft.eventhub/namespaces/mynamespace/authorizationrules/myrule",
    "marketplacePartnerId": "/subscriptions/abcdeabc-1234-1234-ab12-123a1234567a/resourceGroups/test-rg/providers/Microsoft.Datadog/monitors/dd1",
    "logs": [
      {
        "categoryGroup": "allLogs",
        "enabled": true
      }
    ]
  }
}

Gets the subscription diagnostic setting for category

Pedido de amostra

HTTP

GET https://management.azure.com/subscriptions/fb9f25f9-5785-4510-a38f-a62f188eb9f8/providers/Microsoft.Insights/diagnosticSettings/mysetting?api-version=2021-05-01-preview

Resposta da amostra

Código de estado:

200

{
  "id": "subscriptions/fb9f25f9-5785-4510-a38f-a62f188eb9f8/providers/AzureResourceManager/diagnosticSettings/ds4",
  "type": null,
  "name": "ds4",
  "properties": {
    "storageAccountId": "/subscriptions/fb9f25f9-5785-4510-a38f-a62f188eb9f8/resourceGroups/apptest/providers/Microsoft.Storage/storageAccounts/appteststorage1",
    "workspaceId": "/subscriptions/fb9f25f9-5785-4510-a38f-a62f188eb9f8/resourceGroups/apptest/providers/Microsoft.OperationalInsights/workspaces/test1",
    "eventHubAuthorizationRuleId": "/subscriptions/fb9f25f9-5785-4510-a38f-a62f188eb9f8/resourceGroups/apptest/providers/microsoft.eventhub/namespaces/mynamespace/authorizationrules/myrule",
    "marketplacePartnerId": "/subscriptions/abcdeabc-1234-1234-ab12-123a1234567a/resourceGroups/test-rg/providers/Microsoft.Datadog/monitors/dd1",
    "logs": [
      {
        "category": "Security",
        "enabled": true
      },
      {
        "category": "Administrative",
        "enabled": true
      },
      {
        "category": "ServiceHealth",
        "enabled": true
      },
      {
        "category": "Alert",
        "enabled": true
      },
      {
        "category": "Recommendation",
        "enabled": true
      },
      {
        "category": "Policy",
        "enabled": true
      },
      {
        "category": "Autoscale",
        "enabled": true
      },
      {
        "category": "ResourceHealth",
        "enabled": true
      }
    ]
  }
}

Definições

Name	Description
createdByType	O tipo de identidade que criou o recurso.
ErrorResponse	Descreve o formato de Resposta a erros.
SubscriptionDiagnosticSettingsResource	O recurso de definição de diagnóstico da subscrição.
SubscriptionLogSettings	Parte da definição de diagnóstico da subscrição. Especifica as definições de um registo específico.
systemData	Metadados relativos à criação e última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorResponse

Descreve o formato de Resposta a erros.

Name	Tipo	Description
code	string	Código de erro
message	string	Mensagem de erro a indicar por que motivo a operação falhou.

SubscriptionDiagnosticSettingsResource

O recurso de definição de diagnóstico da subscrição.

Name	Tipo	Description
id	string	ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	O nome do recurso
properties.eventHubAuthorizationRuleId	string	O ID do recurso da regra de autorização do hub de eventos.
properties.eventHubName	string	O nome do hub de eventos. Se não for especificado nenhum, o hub de eventos predefinido será selecionado.
properties.logs	SubscriptionLogSettings[]	A lista de definições de registos.
properties.marketplacePartnerId	string	O ID de recurso do ARM completo do recurso do Marketplace para o qual pretende enviar Registos de Diagnóstico.
properties.serviceBusRuleId	string	O ID da regra do service bus da definição de diagnóstico. Isto está aqui para manter a retrocompatibilidade.
properties.storageAccountId	string	O ID de recurso da conta de armazenamento para a qual pretende enviar Registos de Diagnóstico.
properties.workspaceId	string	O ID de recurso do ARM completo da área de trabalho do Log Analytics para a qual gostaria de enviar Registos de Diagnóstico. Exemplo: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2
systemData	systemData	Os metadados do sistema relacionados com este recurso.
type	string	O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

SubscriptionLogSettings

Parte da definição de diagnóstico da subscrição. Especifica as definições de um registo específico.

Name	Tipo	Description
category	string	Nome de uma categoria de Registo de Diagnóstico de Subscrição para um tipo de recurso a que esta definição é aplicada.
categoryGroup	string	Nome de um grupo de categorias do Registo de Diagnóstico de Subscrição para um tipo de recurso a que esta definição é aplicada.
enabled	boolean	um valor que indica se este registo está ativado.

systemData

Metadados relativos à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.