Get-AzSecurityApiCollection
Obtém uma API de Gerenciamento de API do Azure se ela tiver sido integrada ao Microsoft Defender para APIs. Se uma API de Gerenciamento de API do Azure estiver integrada ao Microsoft Defender para APIs, o sistema monitorará as operações dentro da API de Gerenciamento de API do Azure para comportamentos intrusivos e fornecerá alertas para ataques detectados.
Sintaxe
Get-AzSecurityApiCollection
[-SubscriptionId <String[]>]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzSecurityApiCollection
-ApiId <String>
-ResourceGroupName <String>
-ServiceName <String>
[-SubscriptionId <String[]>]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzSecurityApiCollection
-ResourceGroupName <String>
-ServiceName <String>
[-SubscriptionId <String[]>]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzSecurityApiCollection
-ResourceGroupName <String>
[-SubscriptionId <String[]>]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzSecurityApiCollection
-InputObject <ISecurityIdentity>
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Description
Obtém uma API de Gerenciamento de API do Azure se ela tiver sido integrada ao Microsoft Defender para APIs. Se uma API de Gerenciamento de API do Azure estiver integrada ao Microsoft Defender para APIs, o sistema monitorará as operações dentro da API de Gerenciamento de API do Azure para comportamentos intrusivos e fornecerá alertas para ataques detectados.
Exemplos
Exemplo 1: obter um recurso de coleção de api integrado específico
Get-AzSecurityApiCollection -ResourceGroupName apicollectionstests -ServiceName "demoapimservice2" -ApiId "echo-api"
BaseUrl : https://demoapimservice2.azure-api.net/echo
DiscoveredVia : /subscriptions/487bb485-b5b0-471e-9c0d-10717612f869/resourceGroups/apicollectionstests/providers/Microsoft.ApiManagement/service/demoapim
service2
DisplayName : Echo API
Id : /subscriptions/487bb485-b5b0-471e-9c0d-10717612f869/resourceGroups/apicollectionstests/providers/Microsoft.ApiManagement/service/demoapim
service2/providers/Microsoft.Security/apiCollections/echo-api
Name : echo-api
NumberOfApiEndpoint : 6
NumberOfApiEndpointsWithSensitiveDataExposed : 0
NumberOfExternalApiEndpoint : 0
NumberOfInactiveApiEndpoint : 6
NumberOfUnauthenticatedApiEndpoint : 0
ProvisioningState : Succeeded
ResourceGroupName : apicollectionstests
SensitivityLabel :
Type : microsoft.security/apicollections
Exemplo 2: listar coleções de API integradas por nome de serviço
Get-AzSecurityApiCollection -ResourceGroupName "apicollectionstests" -ServiceName "demoapimservice2"
Name ResourceGroupName
---- -----------------
echo-api apicollectionstests
echo-api-2 apicollectionstests
Exemplo 3: listar coleções de API integradas por assinatura
Get-AzSecurityApiCollection
Name ResourceGroupName
---- -----------------
echo-api apicollectionstests
echo-api-2 apicollectionstests
Parâmetros
-ApiId
Identificador de revisão de API. Deve ser exclusivo na instância do serviço de Gerenciamento de API. A revisão não atual tem; rev=n como um sufixo em que n é o número de revisão.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DefaultProfile
O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.
Tipo: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InputObject
Parâmetro de identidade
Tipo: | ISecurityIdentity |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-ResourceGroupName
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ServiceName
O nome do serviço de Gerenciamento de API.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SubscriptionId
ID da assinatura do Azure
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | (Get-AzContext).Subscription.Id |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
Saídas
Azure PowerShell