Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
92 changes: 92 additions & 0 deletions api-reference/v1.0/api/security-authoritytemplate-get.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
---
title: "Get authorityTemplate"
description: "Read the properties and relationships of an authorityTemplate."
author: "sseth"
ms.localizationpriority: medium
ms.prod: "security"
doc_type: apiPageType
---

# Get authorityTemplate
Namespace: microsoft.graph.security

Read the properties and relationships of a [authorityTemplate](../resources/security-authoritytemplate.md) object.

## Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

|Permission type|Permissions (from least to most privileged)|
|:---|:---|
|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All|
|Delegated (personal Microsoft account)|Not supported.|
|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All|

## HTTP request

<!-- {
"blockType": "ignored"
}
-->
``` http
GET /security/labels/authorities/{authorityTemplateId}
GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/authorityTemplate
```

## Optional query parameters
This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).

## Request headers
|Name|Description|
|:---|:---|
|Authorization|Bearer {token}. Required.|

## Request body
Do not supply a request body for this method.

## Response

If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) object in the response body.

## Examples

### Request
The following is an example of a request.

<!-- {
"blockType": "request",
"name": "get_authoritytemplate"
}
-->
``` http
GET https://graph.microsoft.com/v1.0/security/labels/authorities/{authorityTemplateId}
```



### Response
The following is an example of the response.

>**Note:** The response object shown here might be shortened for readability.
<!-- {
"blockType": "response",
"truncated": true,
"@odata.type": "microsoft.graph.security.authorityTemplate"
}
-->
``` http
HTTP/1.1 200 OK
Content-Type: application/json

{
"value": {
"@odata.type": "#microsoft.graph.security.authorityTemplate",
"id": "a94af2e3-853b-6fcc-c898-d61d3a6d9efc",
"displayName": "String",
"createdBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"createdDateTime": "String (timestamp)"
}
}
```

Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
---
title: "Delete subCategoryTemplate"
description: "Delete a subCategoryTemplate object."
author: "sseth"
ms.localizationpriority: medium
ms.prod: "security"
doc_type: apiPageType
---

# Delete subCategoryTemplate
Namespace: microsoft.graph.security

Delete a [subCategoryTemplate](../resources/security-subcategorytemplate.md) object.

## Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

|Permission type|Permissions (from least to most privileged)|
|:---|:---|
|Delegated (work or school account)|RecordsManagement.ReadWrite.All|
|Delegated (personal Microsoft account)|Not supported.|
|Application|RecordsManagement.ReadWrite.All|

## HTTP request

<!-- {
"blockType": "ignored"
}
-->
``` http
DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories/{subCategoryTemplateId}/$ref
```

## Request headers
|Name|Description|
|:---|:---|
|Authorization|Bearer {token}. Required.|

## Request body
Do not supply a request body for this method.

## Response

If successful, this method returns a `204 No Content` response code.

## Examples

### Request
The following is an example of a request.

<!-- {
"blockType": "request",
"name": "delete_subcategorytemplate"
}
-->
``` http
DELETE https://graph.microsoft.com/v1.0/security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories/{subCategoryTemplateId}
```

### Response
The following is an example of the response.
>
<!-- {
"blockType": "response",
"truncated": true
}
-->
``` http
HTTP/1.1 204 No Content
```

89 changes: 89 additions & 0 deletions api-reference/v1.0/api/security-categorytemplate-get.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
---
title: "Get categoryTemplate"
description: "Read the properties and relationships of a categoryTemplate object."
author: "sseth"
ms.localizationpriority: medium
ms.prod: "security"
doc_type: apiPageType
---

# Get categoryTemplate
Namespace: microsoft.graph.security

Read the properties and relationships of a [categoryTemplate](../resources/security-categorytemplate.md) object.

## Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

|Permission type|Permissions (from least to most privileged)|
|:---|:---|
|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All|
|Delegated (personal Microsoft account)|Not supported.|
|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All|

## HTTP request

<!-- {
"blockType": "ignored"
}
-->
``` http
GET /security/labels/categories/{categoryTemplateId}
GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate
```

## Optional query parameters
This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).

## Request headers
|Name|Description|
|:---|:---|
|Authorization|Bearer {token}. Required.|

## Request body
Do not supply a request body for this method.

## Response

If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object in the response body.

## Examples

### Request
The following is an example of a request.

<!-- {
"blockType": "request",
"name": "get_categorytemplate"
}
-->
``` http
GET https://graph.microsoft.com/v1.0/security/labels/categories/{categoryTemplateId}
```

### Response
The following is an example of the response.
>**Note:** The response object shown here might be shortened for readability.
<!-- {
"blockType": "response",
"truncated": true,
"@odata.type": "microsoft.graph.security.categoryTemplate"
}
-->
``` http
HTTP/1.1 200 OK
Content-Type: application/json

{
"value": {
"@odata.type": "#microsoft.graph.security.categoryTemplate",
"id": "e2c79762-34a9-75ba-b6f0-a7c9a57978ef",
"displayName": "String",
"createdBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"createdDateTime": "String (timestamp)"
}
}
```

Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
---
title: "List subCategories"
description: "Get the subCategoryTemplate resources from the subCategories navigation property."
author: "sseth"
ms.localizationpriority: medium
ms.prod: "security"
doc_type: apiPageType
---

# List subCategories
Namespace: microsoft.graph.security

Get a list of subcategories [subCategoryTemplate](../resources/security-subcategorytemplate.md) associated with a category template.

## Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

|Permission type|Permissions (from least to most privileged)|
|:---|:---|
|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All|
|Delegated (personal Microsoft account)|Not supported.|
|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All|

## HTTP request

<!-- {
"blockType": "ignored"
}
-->
``` http
GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories
```

## Optional query parameters
This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).

## Request headers
|Name|Description|
|:---|:---|
|Authorization|Bearer {token}. Required.|

## Request body
Do not supply a request body for this method.

## Response

If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) objects in the response body.

## Examples

### Request
The following is an example of a request.

<!-- {
"blockType": "request",
"name": "list_subcategorytemplate"
}
-->
``` http
GET https://graph.microsoft.com/v1.0/security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories
```


### Response
The following is an example of the response.

>**Note:** The response object shown here might be shortened for readability.
<!-- {
"blockType": "response",
"truncated": true,
"@odata.type": "Collection(microsoft.graph.security.subCategoryTemplate)"
}
-->
``` http
HTTP/1.1 200 OK
Content-Type: application/json

{
"value": [
{
"@odata.type": "#microsoft.graph.security.subCategoryTemplate",
"id": "2ac39915-dbeb-e933-82e2-92b981835fa0",
"displayName": "String",
"createdBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"createdDateTime": "String (timestamp)"
}
]
}
```

Loading