Skip to content

Commit 2432653

Browse files
LauragraLauragra
authored
Merge pull request #25695 from microsoftgraph/main
Merge to publish.
2 parents 1e5fe5f + ee8cc7a commit 2432653

File tree

46 files changed

+1729
-40
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+1729
-40
lines changed

‎api-reference/beta/api/azureadauthentication-get.md

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -22,12 +22,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
2222
<!-- { "blockType": "permissions", "name": "azureadauthentication_get" } -->
2323
[!INCLUDE [permissions-table](../includes/permissions/azureadauthentication-get-permissions.md)]
2424

25-
For delegated scenarios, the calling user needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json):
26-
+ Global Reader
27-
+ Reports Reader
28-
+ Security Administrator
29-
+ Security Operator
30-
+ Security Reader
25+
[!INCLUDE [rbac-entra-health-service-activity-apis](../includes/rbac-for-apis/rbac-entra-health-service-activity-apis.md)]
3126

3227
## HTTP request
3328

‎api-reference/beta/api/certificateauthoritydetail-get.md

Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
---
2+
title: "Get certificateAuthorityDetail"
3+
description: "Read the properties and relationships of a certificateAuthorityDetail object."
4+
author: "suawat"
5+
ms.localizationpriority: medium
6+
ms.subservice: "entra-sign-in"
7+
doc_type: apiPageType
8+
---
9+
10+
# Get certificateAuthorityDetail
11+
12+
Namespace: microsoft.graph
13+
14+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
15+
16+
Read the properties and relationships of a [certificateAuthorityDetail](../resources/certificateauthoritydetail.md) object.
17+
18+
## Permissions
19+
20+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
21+
22+
<!-- {
23+
"blockType": "permissions",
24+
"name": "certificateauthoritydetail-get-permissions"
25+
}
26+
-->
27+
[!INCLUDE [permissions-table](../includes/permissions/certificateauthoritydetail-get-permissions.md)]
28+
29+
[!INCLUDE [rbac-cert-based-authpkis-apis](../includes/rbac-for-apis/rbac-cert-based-authpkis-apis.md)]
30+
31+
## HTTP request
32+
33+
<!-- {
34+
"blockType": "ignored"
35+
}
36+
-->
37+
38+
``` http
39+
GET /directory/publicKeyInfrastructure/certificateBasedAuthConfigurations/{certificateBasedAuthPkiId}/certificateAuthorities/{certificateAuthorityDetailId}
40+
```
41+
42+
## Optional query parameters
43+
44+
This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
45+
46+
## Request headers
47+
48+
|Name|Description|
49+
|:---|:---|
50+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
51+
52+
## Request body
53+
54+
Don't supply a request body for this method.
55+
56+
## Response
57+
58+
If successful, this method returns a `200 OK` response code and a [certificateAuthorityDetail](../resources/certificateauthoritydetail.md) object in the response body.
59+
60+
## Examples
61+
62+
### Request
63+
64+
The following example shows a request.
65+
<!-- {
66+
"blockType": "request",
67+
"name": "get_certificateauthoritydetail"
68+
}
69+
-->
70+
``` http
71+
GET https://graph.microsoft.com/beta/directory/publicKeyInfrastructure/certificateBasedAuthConfigurations/{certificateBasedAuthPkiId}/certificateAuthorities/{certificateAuthorityDetailId}
72+
```
73+
74+
75+
### Response
76+
77+
The following example shows the response.
78+
>**Note:** The response object shown here might be shortened for readability.
79+
<!-- {
80+
"blockType": "response",
81+
"truncated": true,
82+
"@odata.type": "microsoft.graph.certificateAuthorityDetail"
83+
}
84+
-->
85+
``` http
86+
HTTP/1.1 200 OK
87+
Content-Type: application/json
88+
89+
{
90+
"value": {
91+
"@odata.type": "#microsoft.graph.certificateAuthorityDetail",
92+
"id": "90777c92-2eb3-4a68-931d-4a3e1e1c741f",
93+
"deletedDateTime": null,
94+
"certificateAuthorityType": "root",
95+
"certificate": "Binary",
96+
"displayName": "Contoso2 CA1",
97+
"issuer": "Contoso2",
98+
"issuerSubjectKeyIdentifier": "C0E9....711A",
99+
"createdDateTime": "2024-10-25T18:05:28Z",
100+
"expirationDateTime": "2027-08-29T02:05:57Z",
101+
"thumbprint": "C6FA....4E9CF2",
102+
"certificateRevocationListUrl": null,
103+
"deltacertificateRevocationListUrl": null,
104+
"isIssuerHintEnabled": true
105+
}
106+
}
107+
```

‎api-reference/beta/api/certificateauthoritydetail-update.md

Lines changed: 127 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,127 @@
1+
---
2+
title: "Update certificateAuthorityDetail"
3+
description: "Update the properties of a certificateAuthorityDetail object."
4+
author: "suawat"
5+
ms.localizationpriority: medium
6+
ms.subservice: "entra-sign-in"
7+
doc_type: apiPageType
8+
---
9+
10+
# Update certificateAuthorityDetail
11+
12+
Namespace: microsoft.graph
13+
14+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
15+
16+
Update the properties of a [certificateAuthorityDetail](../resources/certificateauthoritydetail.md) object.
17+
18+
## Permissions
19+
20+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
21+
22+
<!-- {
23+
"blockType": "permissions",
24+
"name": "certificateauthoritydetail-update-permissions"
25+
}
26+
-->
27+
[!INCLUDE [permissions-table](../includes/permissions/certificateauthoritydetail-update-permissions.md)]
28+
29+
[!INCLUDE [rbac-cert-based-authpkis-apis](../includes/rbac-for-apis/rbac-cert-based-authpkis-apis.md)]
30+
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
PATCH /directory/publicKeyInfrastructure/certificateBasedAuthConfigurations/{certificateBasedAuthPkiId}/certificateAuthorities/{certificateAuthorityDetailId}
40+
```
41+
42+
## Request headers
43+
44+
|Name|Description|
45+
|:---|:---|
46+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
47+
|Content-Type|application/json. Required.|
48+
49+
## Request body
50+
51+
[!INCLUDE [table-intro](../../includes/update-property-table-intro.md)]
52+
53+
|Property|Type|Description|
54+
|:---|:---|:---|
55+
|certificateAuthorityType|certificateAuthorityType|The type of certificate authority. The possible values are: `root`, `intermediate`, `unknownFutureValue`. |
56+
|certificate|Binary|The type of certificate authority. Possible values are: `root`, `intermediate`.|
57+
|displayName|String|The name of the certificate authority. |
58+
|issuer|String|The issuer of the certificate authority. |
59+
|issuerSubjectKeyIdentifier|String|The subject key identifier of certificate authority. |
60+
|createdDateTime|DateTimeOffset|The date and time when the certificate authority was created. |
61+
|expirationDateTime|DateTimeOffset|The date and time when the certificate authority expires. Required.|
62+
|thumbprint|String|The thumbprint of certificate authority certificate. Required.|
63+
|certificateRevocationListUrl|String|The URL to check if the certificate is revoked. |
64+
|deltacertificateRevocationListUrl|String|The URL to check if the certificate is revoked. |
65+
|isIssuerHintEnabled|Boolean|Indicates whether the certificate picker presents the certificate authority to the user to use for authentication. Default value is `false`. |
66+
67+
68+
69+
## Response
70+
71+
If successful, this method returns a `200 OK` response code and an updated [certificateAuthorityDetail](../resources/certificateauthoritydetail.md) object in the response body.
72+
73+
## Examples
74+
75+
### Request
76+
77+
The following example shows a request.
78+
<!-- {
79+
"blockType": "request",
80+
"name": "update_certificateauthoritydetail"
81+
}
82+
-->
83+
``` http
84+
PATCH https://graph.microsoft.com/beta/directory/publicKeyInfrastructure/certificateBasedAuthConfigurations/{certificateBasedAuthPkiId}/certificateAuthorities/{certificateAuthorityDetailId}
85+
Content-Type: application/json
86+
87+
{
88+
89+
"isIssuerHintEnabled": true
90+
91+
}
92+
```
93+
94+
95+
### Response
96+
97+
The following example shows the response.
98+
>**Note:** The response object shown here might be shortened for readability.
99+
<!-- {
100+
"blockType": "response",
101+
"truncated": true,
102+
"@odata.type": "microsoft.graph.certificateAuthorityDetail"
103+
}
104+
-->
105+
``` http
106+
HTTP/1.1 200 OK
107+
Content-Type: application/json
108+
109+
{
110+
"@odata.type": "#microsoft.graph.certificateAuthorityDetail",
111+
"id": "90777c92-2eb3-4a68-931d-4a3e1e1c741f",
112+
"deletedDateTime": null,
113+
"certificateAuthorityType": "root",
114+
"certificate": "Binary",
115+
"displayName": "Contoso2 CA1",
116+
"issuer": "Contoso2",
117+
"issuerSubjectKeyIdentifier": "C0E9....711A",
118+
"createdDateTime": "2024-10-25T18:05:28Z",
119+
"expirationDateTime": "2027-08-29T02:05:57Z",
120+
"thumbprint": "C6FA....4E9CF2",
121+
"certificateRevocationListUrl": null,
122+
"deltacertificateRevocationListUrl": null,
123+
"isIssuerHintEnabled": true
124+
125+
}
126+
```
127+

‎api-reference/beta/api/certificatebasedauthpki-delete-certificateauthorities.md

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
---
2+
title: "Delete certificateAuthorityDetail"
3+
description: "Delete a certificateAuthorityDetail object."
4+
author: "suawat"
5+
ms.localizationpriority: medium
6+
ms.subservice: "entra-sign-in"
7+
doc_type: apiPageType
8+
---
9+
10+
# Delete certificateAuthorityDetail
11+
12+
Namespace: microsoft.graph
13+
14+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
15+
16+
Delete a [certificateAuthorityDetail](../resources/certificateauthoritydetail.md) object.
17+
18+
## Permissions
19+
20+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
21+
22+
<!-- {
23+
"blockType": "permissions",
24+
"name": "certificatebasedauthpki-delete-certificateauthorities-permissions"
25+
}
26+
-->
27+
[!INCLUDE [permissions-table](../includes/permissions/certificatebasedauthpki-delete-certificateauthorities-permissions.md)]
28+
29+
[!INCLUDE [rbac-cert-based-authpkis-apis](../includes/rbac-for-apis/rbac-cert-based-authpkis-apis.md)]
30+
31+
## HTTP request
32+
33+
<!-- {
34+
"blockType": "ignored"
35+
}
36+
-->
37+
``` http
38+
DELETE /directory/publicKeyInfrastructure/certificateBasedAuthConfigurations/{certificateBasedAuthPkiId}/certificateAuthorities/{certificateAuthorityDetailId}
39+
```
40+
41+
## Request headers
42+
43+
|Name|Description|
44+
|:---|:---|
45+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
46+
47+
## Request body
48+
49+
Don't supply a request body for this method.
50+
51+
## Response
52+
53+
If successful, this method returns a `204 No Content` response code.
54+
55+
## Examples
56+
57+
### Request
58+
59+
The following example shows a request.
60+
<!-- {
61+
"blockType": "request",
62+
"name": "delete_certificateauthoritydetail"
63+
}
64+
-->
65+
``` http
66+
DELETE https://graph.microsoft.com/beta/directory/publicKeyInfrastructure/certificateBasedAuthConfigurations/{certificateBasedAuthPkiId}/certificateAuthorities/{certificateAuthorityDetailId}
67+
```
68+
69+
70+
### Response
71+
72+
The following example shows the response.
73+
<!-- {
74+
"blockType": "response",
75+
"truncated": true
76+
}
77+
-->
78+
``` http
79+
HTTP/1.1 204 No Content
80+
```
81+

0 commit comments

Comments
 (0)