Skip to content

certificateauthoritydetail-update.md

Latest commit

 

History

History
151 lines (115 loc) · 5.87 KB

certificateauthoritydetail-update.md

File metadata and controls

151 lines (115 loc) · 5.87 KB
title Update certificateAuthorityDetail
description Update the properties of a certificateAuthorityDetail object.
author suawat
ms.localizationpriority medium
ms.subservice entra-sign-in
doc_type apiPageType
ms.date 06/23/2025

Update certificateAuthorityDetail

Namespace: microsoft.graph Update the properties of a certificateAuthorityDetail object.

[!INCLUDE national-cloud-support]

Permissions

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. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table] [!INCLUDE rbac-cert-based-authpkis-apis]

HTTP request

PATCH /directory/publicKeyInfrastructure/certificateBasedAuthConfigurations/{certificateBasedAuthPkiId}/certificateAuthorities/{certificateAuthorityDetailId}

Request headers

Name Description
Authorization Bearer {token}. Required. Learn more about authentication and authorization.
Content-Type application/json. Required.

Request body

[!INCLUDE table-intro]

Property Type Description
certificateAuthorityType certificateAuthorityType The type of certificate authority. The possible values are: root, intermediate, unknownFutureValue.
certificate Binary The type of certificate authority. The possible values are: root, intermediate.
displayName String The name of the certificate authority.
issuer String The issuer of the certificate authority.
issuerSubjectKeyIdentifier String The subject key identifier of certificate authority.
createdDateTime DateTimeOffset The date and time when the certificate authority was created.
expirationDateTime DateTimeOffset The date and time when the certificate authority expires. Required.
thumbprint String The thumbprint of certificate authority certificate. Required.
certificateRevocationListUrl String The URL to check if the certificate is revoked.
deltacertificateRevocationListUrl String The URL to check if the certificate is revoked.
isIssuerHintEnabled Boolean Indicates whether the certificate picker presents the certificate authority to the user to use for authentication. Default value is false.

Response

If successful, this method returns a 200 OK response code and an updated certificateAuthorityDetail object in the response body.

Examples

Request

The following example shows a request.

HTTP

PATCH https://graph.microsoft.com/v1.0/directory/publicKeyInfrastructure/certificateBasedAuthConfigurations/{certificateBasedAuthPkiId}/certificateAuthorities/{certificateAuthorityDetailId}
Content-Type: application/json

{

   "isIssuerHintEnabled": true
   
}

C#

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Go

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Java

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PHP

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PowerShell

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Python

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

The following example shows the response.

Note: The response object shown here might be shortened for readability.

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

{
  "@odata.type": "#microsoft.graph.certificateAuthorityDetail",
  "id": "90777c92-2eb3-4a68-931d-4a3e1e1c741f",
  "deletedDateTime": null,
  "certificateAuthorityType": "root",
  "certificate": "Binary",
  "displayName": "Contoso2 CA1",
  "issuer": "Contoso2",
  "issuerSubjectKeyIdentifier": "C0E9....711A",
  "createdDateTime": "2024-10-25T18:05:28Z",
  "expirationDateTime": "2027-08-29T02:05:57Z",
  "thumbprint": "C6FA....4E9CF2",
  "certificateRevocationListUrl": null,
  "deltacertificateRevocationListUrl": null,
  "isIssuerHintEnabled": true

}