Вывод списка подписей

Пространство имен: microsoft.graph

Получите события Внешняя идентификация Microsoft Entra пользователя selfServiceSignUps для клиента.

Максимальный и стандартный размер страницы — 1000 объектов, и по умолчанию возвращаются последние регистрации. Доступны только события регистрации, произошедшие в течение Microsoft Entra ID периода хранения по умолчанию.

Этот API доступен в следующих национальных облачных развертываниях.

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

HTTP-запрос

GET /auditLogs/signUps

Необязательные параметры запросов

Этот метод поддерживает $topпараметры запроса , $skiptokenи $filter OData для настройки ответа. Общие сведения см. в статье Параметры запроса OData.

Чтобы избежать истечения времени ожидания запроса, примените $filter параметр с диапазоном времени для получения всех входов, как показано в примере 1.

Заголовки запросов

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код отклика и коллекцию объектов selfServiceSignUp в теле отклика. Коллекция объектов перечисляется в порядке убывания на основе createdDateTime.

Примеры

Запрос

В этом примере перечислены все события регистрации за определенный период времени. Возвращаются четыре события регистрации, связанные с одной попыткой регистрации. Объект ответа отображает пользователя, зарегистрированного с помощью Email OTP, и включает прерывание, связанное с проверкой личности пользователя (путем ввода OTP, отправленного на адрес электронной почты пользователя).

GET https://graph.microsoft.com/beta/auditLogs/signUps?$filter=createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.AuditLogs.SignUps.GetAsync((requestConfiguration) =>
{
	requestConfiguration.QueryParameters.Filter = "createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z";
});

mgc-beta audit-logs sign-ups list --filter "createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z"

// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphauditlogs "github.com/microsoftgraph/msgraph-beta-sdk-go/auditlogs"
	  //other-imports
)


requestFilter := "createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z"

requestParameters := &graphauditlogs.AuditLogsSignUpsRequestBuilderGetQueryParameters{
	Filter: &requestFilter,
}
configuration := &graphauditlogs.AuditLogsSignUpsRequestBuilderGetRequestConfiguration{
	QueryParameters: requestParameters,
}

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
signUps, err := graphClient.AuditLogs().SignUps().Get(context.Background(), configuration)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

SelfServiceSignUpCollectionResponse result = graphClient.auditLogs().signUps().get(requestConfiguration -> {
	requestConfiguration.queryParameters.filter = "createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z";
});

const options = {
	authProvider,
};

const client = Client.init(options);

let signUps = await client.api('/auditLogs/signUps')
	.version('beta')
	.filter('createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z')
	.get();

<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\AuditLogs\SignUps\SignUpsRequestBuilderGetRequestConfiguration;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestConfiguration = new SignUpsRequestBuilderGetRequestConfiguration();
$queryParameters = SignUpsRequestBuilderGetRequestConfiguration::createQueryParameters();
$queryParameters->filter = "createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z";
$requestConfiguration->queryParameters = $queryParameters;


$result = $graphServiceClient->auditLogs()->signUps()->get($requestConfiguration)->wait();

Import-Module Microsoft.Graph.Beta.Reports

Get-MgBetaAuditLogSignUp -Filter "createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z" 

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.audit_logs.sign_ups.sign_ups_request_builder import SignUpsRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
query_params = SignUpsRequestBuilder.SignUpsRequestBuilderGetQueryParameters(
		filter = "createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z",
)

request_configuration = RequestConfiguration(
query_parameters = query_params,
)

result = await graph_client.audit_logs.sign_ups.get(request_configuration = request_configuration)

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#auditLogs/signUps",
    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET auditLogs/signUps?$select=appDisplayName,appId",
    "value": [
        {
            "appDisplayName": "TestApp4",
            "appId": "94559aba-b733-468e-aaec-44cc4e7f0b58",
            "correlationId": "f4414243-b0ee-4030-9c0c-d661c716a6b8",
            "createdDateTime": "2024-10-15T01:58:09.287604Z",
            "id": "921e63bd-a516-4976-a537-a6710d6a0000",
            "signUpStage": "userCreation",
            "signUpIdentityProvider": "Email OTP",
            "appliedEventListeners": [],
            "status": {
                "errorCode": 0,
                "failureReason": null,
                "additionalDetails": null
            },
            "signUpIdentity": {
                "signUpIdentifier": "[email protected]",
                "signUpIdentifierType": "emailAddress"
            },
            "userId": "9fb7a577-9469-4489-912d-bc58a5bca276"
        },
        {
            "appDisplayName": "TestApp4",
            "appId": "94559aba-b733-468e-aaec-44cc4e7f0b58",
            "correlationId": "f4414243-b0ee-4030-9c0c-d661c716a6b8",
            "createdDateTime": "2024-10-15T01:58:08.383114Z",
            "id": "5b515b07-411f-4759-a389-bce8289f0000",
            "signUpStage": "attributeCollectionAndValidation",
            "signUpIdentityProvider": "Email OTP",
            "userId": null,
            "appliedEventListeners": [],
            "status": {
                "errorCode": 0,
                "failureReason": null,
                "additionalDetails": null
            },
            "signUpIdentity": {
                "signUpIdentifier": "[email protected]",
                "signUpIdentifierType": "emailAddress"
            }
        },
        {
            "appDisplayName": "TestApp4",
            "appId": "94559aba-b733-468e-aaec-44cc4e7f0b58",
            "correlationId": "f4414243-b0ee-4030-9c0c-d661c716a6b8",
            "createdDateTime": "2024-10-15T01:57:49.368731Z",
            "id": "1ce058e4-d023-4ae4-9236-0c9d0f0f0200",
            "signUpStage": "credentialValidation",
            "signUpIdentityProvider": "Email OTP",
            "userId": null,
            "appliedEventListeners": [],
            "status": {
                "errorCode": 1002013,
                "failureReason": null,
                "additionalDetails": null
            },
            "signUpIdentity": {
                "signUpIdentifier": "[email protected]",
                "signUpIdentifierType": "emailAddress"
            }
        },
        {
            "appDisplayName": null,
            "appId": "94559aba-b733-468e-aaec-44cc4e7f0b58",
            "correlationId": "f4414243-b0ee-4030-9c0c-d661c716a6b8",
            "createdDateTime": "2024-10-15T01:57:36.362145Z",
            "id": "921e63bd-a516-4976-a537-a671036a0000",
            "signUpStage": "credentialCollection",
            "signUpIdentityProvider": "Email OTP",
            "userId": null,
            "appliedEventListeners": [],
            "status": {
                "errorCode": 0,
                "failureReason": null,
                "additionalDetails": null
            },
            "signUpIdentity": {
                "signUpIdentifier": "[email protected]",
                "signUpIdentifierType": "emailAddress"
            }
        }
    ]
}