Address PR comments

This commit is contained in:
Carlos Monastyrski
2025-09-19 03:43:22 -03:00
parent 8130be5e2f
commit 27dbe5b013
72 changed files with 2913 additions and 1367 deletions
@@ -0,0 +1,150 @@
---
title: "Update Azure Key Vault PKI Sync"
openapi: "PATCH /api/v1/pki/syncs/azure-key-vault/{pkiSyncId}"
---
<Info>
This endpoint updates an existing Azure Key Vault PKI sync.
</Info>
## Request
<ParamField path="pkiSyncId" type="string" required>
The ID of the Azure Key Vault PKI sync to update
</ParamField>
<ParamField query="projectId" type="string" optional>
Project ID for additional authorization (will be inferred if not provided)
</ParamField>
<ParamField body="name" type="string" optional>
Name of the PKI sync (1-64 characters)
</ParamField>
<ParamField body="description" type="string" optional>
Description of the PKI sync
</ParamField>
<ParamField body="isAutoSyncEnabled" type="boolean" optional>
Whether automatic synchronization is enabled when certificates are issued
</ParamField>
<ParamField body="destinationConfig" type="object" optional>
Azure Key Vault specific configuration
<Expandable title="properties">
<ParamField body="vaultBaseUrl" type="string">
Base URL of the Azure Key Vault (e.g., "https://my-vault.vault.azure.net/")
</ParamField>
</Expandable>
</ParamField>
<ParamField body="syncOptions" type="object" optional>
Sync-specific options and settings
</ParamField>
<ParamField body="subscriberId" type="string" optional>
ID of the PKI subscriber to connect this sync to. If provided, certificates issued by this subscriber will be automatically synced to Azure Key Vault.
</ParamField>
<ParamField body="connectionId" type="string" optional>
ID of the Azure Key Vault app connection to use for this sync
</ParamField>
## Response
Returns the updated Azure Key Vault PKI sync object.
<ResponseField name="id" type="string">
Unique identifier for the PKI sync
</ResponseField>
<ResponseField name="name" type="string">
Updated name of the PKI sync
</ResponseField>
<ResponseField name="description" type="string" optional>
Updated description of the PKI sync
</ResponseField>
<ResponseField name="destination" type="string">
Always "azure-key-vault"
</ResponseField>
<ResponseField name="isAutoSyncEnabled" type="boolean">
Updated automatic synchronization setting
</ResponseField>
<ResponseField name="destinationConfig" type="object">
Updated Azure Key Vault specific configuration
</ResponseField>
<ResponseField name="syncOptions" type="object">
Updated sync-specific options and settings
</ResponseField>
<ResponseField name="projectId" type="string">
ID of the project this sync belongs to
</ResponseField>
<ResponseField name="subscriberId" type="string" optional>
Updated PKI subscriber ID this sync is connected to
</ResponseField>
<ResponseField name="connectionId" type="string">
Updated Azure Key Vault app connection ID
</ResponseField>
<ResponseField name="createdAt" type="string">
Timestamp when the PKI sync was created
</ResponseField>
<ResponseField name="updatedAt" type="string">
Timestamp when the PKI sync was last updated
</ResponseField>
<RequestExample>
```bash cURL
curl -X PATCH "https://app.infisical.com/api/v1/pki/syncs/azure-key-vault/ps_12345" \
-H "Authorization: Bearer <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"name": "Updated Production Azure Key Vault Sync",
"isAutoSyncEnabled": false,
"destinationConfig": {
"vaultBaseUrl": "https://my-new-vault.vault.azure.net/"
}
}'
```
</RequestExample>
<ResponseExample>
```json Response
{
"id": "ps_12345",
"name": "Updated Production Azure Key Vault Sync",
"description": "Sync certificates to production Key Vault",
"destination": "azure-key-vault",
"isAutoSyncEnabled": false,
"destinationConfig": {
"vaultBaseUrl": "https://my-new-vault.vault.azure.net/"
},
"syncOptions": {},
"projectId": "proj_12345",
"subscriberId": "sub_12345",
"connectionId": "conn_12345",
"syncStatus": "succeeded",
"lastSyncedAt": "2023-12-01T10:00:00Z",
"lastSyncMessage": "Successfully synced 3 certificates",
"removeStatus": null,
"lastRemovedAt": null,
"lastRemoveMessage": null,
"connection": {
"id": "conn_12345",
"name": "Azure Production Connection",
"app": "azure-key-vault"
},
"createdAt": "2023-11-01T10:00:00Z",
"updatedAt": "2023-12-01T11:30:00Z"
}
```
</ResponseExample>