{"files":{"SKILL.md":"---\nname: dnsmanagementclient\ndescription: \"DnsManagementClient API skill. Use when working with DnsManagementClient for subscriptions. Covers 14 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# DnsManagementClient\nAPI version: 2018-05-01\n\n## Auth\nOAuth2\n\n## Base URL\nhttps://management.azure.com\n\n## Setup\n1. Configure auth: OAuth2\n2. GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName} -- gets a record set.\n3. POST /subscriptions/{subscriptionId}/providers/Microsoft.Network/getDnsResourceReference -- create first getDnsResourceReference\n\n## Endpoints\n14 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Subscriptions\n| Method | Path | Description |\n|--------|------|-------------|\n| PATCH | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName} | Updates a record set within a DNS zone. |\n| PUT | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName} | Creates or updates a record set within a DNS zone. |\n| DELETE | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName} | Deletes a record set from a DNS zone. This operation cannot be undone. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName} | Gets a record set. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType} | Lists the record sets of a specified type in a DNS zone. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/recordsets | Lists all record sets in a DNS zone. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/all | Lists all record sets in a DNS zone. |\n| PUT | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName} | Creates or updates a DNS zone. Does not modify DNS records within the zone. |\n| DELETE | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName} | Deletes a DNS zone. WARNING: All DNS records in the zone will also be deleted. This operation cannot be undone. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName} | Gets a DNS zone. Retrieves the zone properties, but not the record sets within the zone. |\n| PATCH | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName} | Updates a DNS zone. Does not modify DNS records within the zone. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones | Lists the DNS zones within a resource group. |\n| POST | /subscriptions/{subscriptionId}/providers/Microsoft.Network/getDnsResourceReference | Returns the DNS records specified by the referencing targetResourceIds. |\n| GET | /subscriptions/{subscriptionId}/providers/Microsoft.Network/dnszones | Lists the DNS zones in all resource groups in a subscription. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Partially update a dnsZone?\" -> PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName}\n- \"Update a dnsZone?\" -> PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName}\n- \"Delete a dnsZone?\" -> DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName}\n- \"Get dnsZone details?\" -> GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName}\n- \"List all recordsets?\" -> GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/recordsets\n- \"List all all?\" -> GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/all\n- \"List all dnsZones?\" -> GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones\n- \"Create a getDnsResourceReference?\" -> POST /subscriptions/{subscriptionId}/providers/Microsoft.Network/getDnsResourceReference\n- \"List all dnszones?\" -> GET /subscriptions/{subscriptionId}/providers/Microsoft.Network/dnszones\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 DnsManagementClient\n@base https://management.azure.com\n@version 2018-05-01\n@auth OAuth2\n@common_fields {api-version: any # Specifies the API version., subscriptionId: any # Specifies the Azure subscription ID, which uniquely identifies the Microsoft Azure subscription.}\n@endpoints 14\n@toc subscriptions(14)\n\n@endpoint PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName}\n@desc Updates a record set within a DNS zone.\n@required {resourceGroupName: any # The name of the resource group., zoneName: any # The name of the DNS zone (without a terminating dot)., relativeRecordSetName: any # The name of the record set, relative to the name of the zone., recordType: any # The type of DNS record in this record set., parameters: any # Parameters supplied to the Update operation.}\n@optional {If-Match: any # The etag of the record set. Omit this value to always overwrite the current record set. Specify the last-seen etag value to prevent accidentally overwriting concurrent changes.}\n@returns(200) The record set has been updated.\n\n@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName}\n@desc Creates or updates a record set within a DNS zone.\n@required {resourceGroupName: any # The name of the resource group., zoneName: any # The name of the DNS zone (without a terminating dot)., relativeRecordSetName: any # The name of the record set, relative to the name of the zone., recordType: any # The type of DNS record in this record set. Record sets of type SOA can be updated but not created (they are created when the DNS zone is created)., parameters: any # Parameters supplied to the CreateOrUpdate operation.}\n@optional {If-Match: any # The etag of the record set. Omit this value to always overwrite the current record set. Specify the last-seen etag value to prevent accidentally overwriting any concurrent changes., If-None-Match: any # Set to '*' to allow a new record set to be created, but to prevent updating an existing record set. Other values will be ignored.}\n@returns(200) The record set has been updated.\n@returns(201) The record set has been created.\n\n@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName}\n@desc Deletes a record set from a DNS zone. This operation cannot be undone.\n@required {resourceGroupName: any # The name of the resource group., zoneName: any # The name of the DNS zone (without a terminating dot)., relativeRecordSetName: any # The name of the record set, relative to the name of the zone., recordType: any # The type of DNS record in this record set. Record sets of type SOA cannot be deleted (they are deleted when the DNS zone is deleted).}\n@optional {If-Match: any # The etag of the record set. Omit this value to always delete the current record set. Specify the last-seen etag value to prevent accidentally deleting any concurrent changes.}\n@returns(200) The record set has been deleted.\n@returns(204) The record set was not found.\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName}\n@desc Gets a record set.\n@required {resourceGroupName: any # The name of the resource group., zoneName: any # The name of the DNS zone (without a terminating dot)., relativeRecordSetName: any # The name of the record set, relative to the name of the zone., recordType: any # The type of DNS record in this record set.}\n@returns(200) Success.\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}\n@desc Lists the record sets of a specified type in a DNS zone.\n@required {resourceGroupName: any # The name of the resource group., zoneName: any # The name of the DNS zone (without a terminating dot)., recordType: any # The type of record sets to enumerate.}\n@optional {$top: any # The maximum number of record sets to return. If not specified, returns up to 100 record sets., $recordsetnamesuffix: any # The suffix label of the record set name that has to be used to filter the record set enumerations. If this parameter is specified, Enumeration will return only records that end with .}\n@returns(200) Success.\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/recordsets\n@desc Lists all record sets in a DNS zone.\n@required {resourceGroupName: any # The name of the resource group., zoneName: any # The name of the DNS zone (without a terminating dot).}\n@optional {$top: any # The maximum number of record sets to return. If not specified, returns up to 100 record sets., $recordsetnamesuffix: any # The suffix label of the record set name that has to be used to filter the record set enumerations. If this parameter is specified, Enumeration will return only records that end with .}\n@returns(200) Success.\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/all\n@desc Lists all record sets in a DNS zone.\n@required {resourceGroupName: any # The name of the resource group., zoneName: any # The name of the DNS zone (without a terminating dot).}\n@optional {$top: any # The maximum number of record sets to return. If not specified, returns up to 100 record sets., $recordsetnamesuffix: any # The suffix label of the record set name that has to be used to filter the record set enumerations. If this parameter is specified, Enumeration will return only records that end with .}\n@returns(200) Success.\n\n@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}\n@desc Creates or updates a DNS zone. Does not modify DNS records within the zone.\n@required {resourceGroupName: any # The name of the resource group., zoneName: any # The name of the DNS zone (without a terminating dot)., parameters: any # Parameters supplied to the CreateOrUpdate operation.}\n@optional {If-Match: any # The etag of the DNS zone. Omit this value to always overwrite the current zone. Specify the last-seen etag value to prevent accidentally overwriting any concurrent changes., If-None-Match: any # Set to '*' to allow a new DNS zone to be created, but to prevent updating an existing zone. Other values will be ignored.}\n@returns(200) The DNS zone has been updated.\n@returns(201) The DNS zone has been created.\n\n@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}\n@desc Deletes a DNS zone. WARNING: All DNS records in the zone will also be deleted. This operation cannot be undone.\n@required {resourceGroupName: any # The name of the resource group., zoneName: any # The name of the DNS zone (without a terminating dot).}\n@optional {If-Match: any # The etag of the DNS zone. Omit this value to always delete the current zone. Specify the last-seen etag value to prevent accidentally deleting any concurrent changes.}\n@returns(200) The DNS zone has been deleted.\n@returns(202) The DNS zone delete operation has been accepted and will complete asynchronously.\n@returns(204) The DNS zone was not found.\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}\n@desc Gets a DNS zone. Retrieves the zone properties, but not the record sets within the zone.\n@required {resourceGroupName: any # The name of the resource group., zoneName: any # The name of the DNS zone (without a terminating dot).}\n@returns(200) Success.\n\n@endpoint PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}\n@desc Updates a DNS zone. Does not modify DNS records within the zone.\n@required {resourceGroupName: any # The name of the resource group., zoneName: any # The name of the DNS zone (without a terminating dot)., parameters: any # Parameters supplied to the Update operation.}\n@optional {If-Match: any # The etag of the DNS zone. Omit this value to always overwrite the current zone. Specify the last-seen etag value to prevent accidentally overwriting any concurrent changes.}\n@returns(200) The DNS zone has been updated.\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones\n@desc Lists the DNS zones within a resource group.\n@required {resourceGroupName: any # The name of the resource group.}\n@optional {$top: any # The maximum number of record sets to return. If not specified, returns up to 100 record sets.}\n@returns(200) Success.\n\n@endpoint POST /subscriptions/{subscriptionId}/providers/Microsoft.Network/getDnsResourceReference\n@desc Returns the DNS records specified by the referencing targetResourceIds.\n@required {parameters: any # Properties for dns resource reference request.}\n@returns(200) Success.\n\n@endpoint GET /subscriptions/{subscriptionId}/providers/Microsoft.Network/dnszones\n@desc Lists the DNS zones in all resource groups in a subscription.\n@optional {$top: any # The maximum number of DNS zones to return. If not specified, returns up to 100 zones.}\n@returns(200) Success.\n\n@end\n"}}