{"files":{"SKILL.md":"---\nname: appservicecertificateorders-api-client\ndescription: \"AppServiceCertificateOrders API Client API skill. Use when working with AppServiceCertificateOrders API Client for subscriptions. Covers 20 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# AppServiceCertificateOrders API Client\nAPI version: 2018-02-01\n\n## Auth\nOAuth2\n\n## Base URL\nhttps://management.azure.com\n\n## Setup\n1. Configure auth: OAuth2\n2. GET /subscriptions/{subscriptionId}/providers/Microsoft.CertificateRegistration/certificateOrders -- list all certificate orders in a subscription.\n3. POST /subscriptions/{subscriptionId}/providers/Microsoft.CertificateRegistration/validateCertificateRegistrationInformation -- create first validateCertificateRegistrationInformation\n\n## Endpoints\n20 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Subscriptions\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /subscriptions/{subscriptionId}/providers/Microsoft.CertificateRegistration/certificateOrders | List all certificate orders in a subscription. |\n| POST | /subscriptions/{subscriptionId}/providers/Microsoft.CertificateRegistration/validateCertificateRegistrationInformation | Validate information for a certificate order. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders | Get certificate orders in a resource group. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName} | Get a certificate order. |\n| PUT | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName} | Create or update a certificate purchase order. |\n| DELETE | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName} | Delete an existing certificate order. |\n| PATCH | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName} | Create or update a certificate purchase order. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates | List all certificates associated with a certificate order. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name} | Get the certificate associated with a certificate order. |\n| PUT | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name} | Creates or updates a certificate and associates with key vault secret. |\n| DELETE | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name} | Delete the certificate associated with a certificate order. |\n| PATCH | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name} | Creates or updates a certificate and associates with key vault secret. |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/reissue | Reissue an existing certificate order. |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/renew | Renew an existing certificate order. |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/resendEmail | Resend certificate email. |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/resendRequestEmails | Verify domain ownership for this certificate order. |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/retrieveSiteSeal | Verify domain ownership for this certificate order. |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/verifyDomainOwnership | Verify domain ownership for this certificate order. |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}/retrieveCertificateActions | Retrieve the list of certificate actions. |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}/retrieveEmailHistory | Retrieve email history. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all certificateOrders?\" -> GET /subscriptions/{subscriptionId}/providers/Microsoft.CertificateRegistration/certificateOrders\n- \"Create a validateCertificateRegistrationInformation?\" -> POST /subscriptions/{subscriptionId}/providers/Microsoft.CertificateRegistration/validateCertificateRegistrationInformation\n- \"Get certificateOrder details?\" -> GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}\n- \"Update a certificateOrder?\" -> PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}\n- \"Delete a certificateOrder?\" -> DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}\n- \"Partially update a certificateOrder?\" -> PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}\n- \"List all certificates?\" -> GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates\n- \"Get certificate details?\" -> GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}\n- \"Update a certificate?\" -> PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}\n- \"Delete a certificate?\" -> DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}\n- \"Partially update a certificate?\" -> PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}\n- \"Create a reissue?\" -> POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/reissue\n- \"Create a renew?\" -> POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/renew\n- \"Create a resendEmail?\" -> POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/resendEmail\n- \"Create a resendRequestEmail?\" -> POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/resendRequestEmails\n- \"Create a retrieveSiteSeal?\" -> POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/retrieveSiteSeal\n- \"Create a verifyDomainOwnership?\" -> POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/verifyDomainOwnership\n- \"Create a retrieveCertificateAction?\" -> POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}/retrieveCertificateActions\n- \"Create a retrieveEmailHistory?\" -> POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}/retrieveEmailHistory\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api AppServiceCertificateOrders API Client\n@base https://management.azure.com\n@version 2018-02-01\n@auth OAuth2\n@common_fields {subscriptionId: any # Your Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000)., api-version: any # API Version}\n@endpoints 20\n@toc subscriptions(20)\n\n@endpoint GET /subscriptions/{subscriptionId}/providers/Microsoft.CertificateRegistration/certificateOrders\n@desc List all certificate orders in a subscription.\n@returns(200) OK\n\n@endpoint POST /subscriptions/{subscriptionId}/providers/Microsoft.CertificateRegistration/validateCertificateRegistrationInformation\n@desc Validate information for a certificate order.\n@required {appServiceCertificateOrder: map # Information for a certificate order.}\n@returns(204) No Content\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders\n@desc Get certificate orders in a resource group.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs.}\n@returns(200) OK\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}\n@desc Get a certificate order.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order..}\n@returns(200) OK\n\n@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}\n@desc Create or update a certificate purchase order.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order., certificateDistinguishedName: map # Distinguished name to use for the certificate order.}\n@returns(200) App Service Certificate Order is created.\n@returns(201) App Service Certificate Order creation operation is in progress\n\n@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}\n@desc Delete an existing certificate order.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order.}\n@returns(200) Successfully deleted certificate order.\n@returns(204) Certificate order does not exist.\n\n@endpoint PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}\n@desc Create or update a certificate purchase order.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order., certificateDistinguishedName: map # Distinguished name to use for the certificate order.}\n@returns(200) App Service Certificate Order is created.\n@returns(201) App Service Certificate Order creation operation is in progress\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates\n@desc List all certificates associated with a certificate order.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order.}\n@returns(200) OK\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}\n@desc Get the certificate associated with a certificate order.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order., name: any # Name of the certificate.}\n@returns(200) OK\n\n@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}\n@desc Creates or updates a certificate and associates with key vault secret.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order., name: any # Name of the certificate., keyVaultCertificate: map # Key vault certificate resource Id.}\n@returns(200) App Service Certificate is created.\n@returns(201) App Service Certificate creation operation is in progress\n\n@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}\n@desc Delete the certificate associated with a certificate order.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order., name: any # Name of the certificate.}\n@returns(200) Successfully deleted certificate.\n@returns(204) Certificate does not exist.\n\n@endpoint PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}\n@desc Creates or updates a certificate and associates with key vault secret.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order., name: any # Name of the certificate., keyVaultCertificate: map # Key vault certificate resource Id.}\n@returns(200) App Service Certificate is created.\n@returns(201) App Service Certificate creation operation is in progress\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/reissue\n@desc Reissue an existing certificate order.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order., reissueCertificateOrderRequest: map # Parameters for the reissue.}\n@returns(204) No Content\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/renew\n@desc Renew an existing certificate order.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order., renewCertificateOrderRequest: map # Renew parameters}\n@returns(204) No Content\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/resendEmail\n@desc Resend certificate email.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order.}\n@returns(204) No Content\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/resendRequestEmails\n@desc Verify domain ownership for this certificate order.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order., nameIdentifier: any # Email address}\n@returns(204) No Content\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/retrieveSiteSeal\n@desc Verify domain ownership for this certificate order.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order., siteSealRequest: map # Site seal request.}\n@returns(200) OK\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/verifyDomainOwnership\n@desc Verify domain ownership for this certificate order.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., certificateOrderName: any # Name of the certificate order.}\n@returns(204) No Content\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}/retrieveCertificateActions\n@desc Retrieve the list of certificate actions.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., name: any # Name of the certificate order.}\n@returns(200) OK\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}/retrieveEmailHistory\n@desc Retrieve email history.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., name: any # Name of the certificate order.}\n@returns(200) OK\n\n@end\n"}}