フィードバック 編集

subjectRightsRequest の作成

  • [アーティクル]

名前空間: microsoft.graph

新しい subjectRightsRequest オブジェクトを作成 します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) SubjectRightsRequest.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション サポート対象外

HTTP 要求

POST /privacy/subjectRightsRequests

要求ヘッダー

名前 説明
Authorization ベアラー {token}。必須。
Content-Type application/json. Required.

要求本文

要求本文で 、subjectRightsRequest オブジェクトの JSON 表記を指定します。

次の表に、subjectRightsRequest を作成するときに必要 なプロパティを示します。

プロパティ 型 説明
dataSubject microsoft.graph.dataSubject 要求のデータ主体のプロパティを格納します。
dataSubjectType dataSubjectType データ主体の種類。 可能な値は、customer、currentEmployee、formerEmployee、prospectiveEmployee、student、teacher、faculty、other、unknownFutureValue です。
説明 String 要求の説明。
displayName String 要求の名前。
internalDueDateTime DateTimeOffset 要求の完了を追跡するために使用される内部期日。
規制 String コレクション 要求に関する 1 つ以上の規制。
type subjectRightsRequestType 要求の種類。 可能な値は、export、delete、access、tagForAction、unknownFutureValue です。

応答

成功した場合、このメソッドは応答コードと、応答本文 201 Created の subjectRightsRequest オブジェクトを返します。

例

要求

POST https://graph.microsoft.com/v1.0/privacy/subjectRightsRequests
Content-Type: application/json

{
    "type": "microsoft.graph.subjectRightsRequestType",
    "dataSubjectType": "microsoft.graph.dataSubjectType",
    "regulations": ["String"],
    "displayName": "String",
    "description": "String",
    "internalDueDateTime": "String (timestamp)",
    "dataSubject": {
        "firstName": "String",
        "lastName": "String",
        "email": "String",
        "residency": "String",
        "phoneNumber": "String",
        "SSN": "String"
    }
}

応答

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 201 Created
Content-Type: application/json

{
    "type": "microsoft.graph.subjectRightsRequestType",
    "dataSubjectType": "microsoft.graph.dataSubjectType",
    "regulations": [
        "String"
    ],
    "displayName": "String",
    "description": "String",
    "status": "active",
    "internalDueDateTime": "String",
    "lastModifiedDateTime": "String",
    "id": "String",
    "createdDateTime": "String",
    "stages": [
        {
            "stage": "contentRetrieval",
            "status": "notStarted",
            "error": 
            {
                "@odata.type": "microsoft.graph.publicError"
            }
        },
        {
            "stage": "contentReview",
            "status": "notStarted",
            "error": 
            {
                "@odata.type": "microsoft.graph.publicError"
            }
        },
        {
            "stage": "generateReport",
            "status": "notStarted",
            "error": 
            {
                "@odata.type": "microsoft.graph.publicError"
            }
        },
        {
            "stage": "caseResolved",
            "status": "notStarted",
            "error": 
            {
                "@odata.type": "microsoft.graph.publicError"
            }
        }
    ],
    "createdBy": {
        "@odata.type": "microsoft.graph.identitySet"
    },
    "lastModifiedBy": {
        "@odata.type": "microsoft.graph.identitySet"
    },
    "dataSubject": {
        "firstName": "String",
        "lastName": "String",
        "email": "String",
        "residency": "String",
        "phoneNumber": "String",
        "SSN": "String"
    },
    "team": {
        "id": "String (identifier)",
        "webUrl": "String"
    }
}