domains
Creates, updates, deletes, gets or lists a domains
resource.
Overview
Name | domains |
Type | Resource |
Id | azure.app_service.domains |
Fields
The following fields are returned by SELECT
queries:
- get
- list_by_resource_group
- list
Name | Datatype | Description |
---|---|---|
id | string (arm-id) | Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name | string | The name of the resource |
properties | object | Domain resource specific properties |
systemData | object | Azure Resource Manager metadata containing createdBy and modifiedBy information. |
type | string | The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts" |
Name | Datatype | Description |
---|---|---|
id | string (arm-id) | Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name | string | The name of the resource |
properties | object | Domain resource specific properties |
systemData | object | Azure Resource Manager metadata containing createdBy and modifiedBy information. |
type | string | The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts" |
Name | Datatype | Description |
---|---|---|
id | string (arm-id) | Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name | string | The name of the resource |
properties | object | Domain resource specific properties |
systemData | object | Azure Resource Manager metadata containing createdBy and modifiedBy information. |
type | string | The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts" |
Methods
The following methods are available for this resource:
Name | Accessible by | Required Params | Optional Params | Description |
---|---|---|---|---|
get | select | resourceGroupName , domainName , subscriptionId | Description for Get a domain. | |
list_by_resource_group | select | resourceGroupName , subscriptionId | Description for Get all domains in a resource group. | |
list | select | subscriptionId | Description for Get all domains in a subscription. | |
create_or_update | insert | resourceGroupName , domainName , subscriptionId | Description for Creates or updates a domain. | |
update | update | resourceGroupName , domainName , subscriptionId | Description for Creates or updates a domain. | |
delete | delete | resourceGroupName , domainName , subscriptionId | forceHardDeleteDomain | Description for Delete a domain. |
check_availability | exec | subscriptionId | Description for Check if a domain is available for registration. | |
renew | exec | resourceGroupName , domainName , subscriptionId | Description for Renew a domain. | |
transfer_out | exec | resourceGroupName , domainName , subscriptionId |
Parameters
Parameters can be passed in the WHERE
clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
Name | Datatype | Description |
---|---|---|
domainName | string | Name of domain. |
resourceGroupName | string | Name of the resource group to which the resource belongs. |
subscriptionId | string | Your Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000). |
forceHardDeleteDomain | boolean | Specify true to delete the domain immediately. The default is false which deletes the domain after 24 hours. |
SELECT
examples
- get
- list_by_resource_group
- list
Description for Get a domain.
SELECT
id,
name,
properties,
systemData,
type
FROM azure.app_service.domains
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND domainName = '{{ domainName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
;
Description for Get all domains in a resource group.
SELECT
id,
name,
properties,
systemData,
type
FROM azure.app_service.domains
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
;
Description for Get all domains in a subscription.
SELECT
id,
name,
properties,
systemData,
type
FROM azure.app_service.domains
WHERE subscriptionId = '{{ subscriptionId }}' -- required
;
INSERT
examples
- create_or_update
- Manifest
Description for Creates or updates a domain.
INSERT INTO azure.app_service.domains (
data__properties,
resourceGroupName,
domainName,
subscriptionId
)
SELECT
'{{ properties }}',
'{{ resourceGroupName }}',
'{{ domainName }}',
'{{ subscriptionId }}'
RETURNING
id,
name,
properties,
systemData,
type
;
# Description fields are for documentation purposes
- name: domains
props:
- name: resourceGroupName
value: string
description: Required parameter for the domains resource.
- name: domainName
value: string
description: Required parameter for the domains resource.
- name: subscriptionId
value: string
description: Required parameter for the domains resource.
- name: properties
value: object
description: |
Domain resource specific properties
UPDATE
examples
- update
Description for Creates or updates a domain.
UPDATE azure.app_service.domains
SET
data__kind = '{{ kind }}',
data__properties = '{{ properties }}'
WHERE
resourceGroupName = '{{ resourceGroupName }}' --required
AND domainName = '{{ domainName }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
RETURNING
id,
name,
properties,
systemData,
type;
DELETE
examples
- delete
Description for Delete a domain.
DELETE FROM azure.app_service.domains
WHERE resourceGroupName = '{{ resourceGroupName }}' --required
AND domainName = '{{ domainName }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
AND forceHardDeleteDomain = '{{ forceHardDeleteDomain }}'
;
Lifecycle Methods
- check_availability
- renew
- transfer_out
Description for Check if a domain is available for registration.
EXEC azure.app_service.domains.check_availability
@subscriptionId='{{ subscriptionId }}' --required
@@json=
'{
"name": "{{ name }}"
}'
;
Description for Renew a domain.
EXEC azure.app_service.domains.renew
@resourceGroupName='{{ resourceGroupName }}' --required,
@domainName='{{ domainName }}' --required,
@subscriptionId='{{ subscriptionId }}' --required
;
Successfully returned transfer code to transfer domain to another registrar.
EXEC azure.app_service.domains.transfer_out
@resourceGroupName='{{ resourceGroupName }}' --required,
@domainName='{{ domainName }}' --required,
@subscriptionId='{{ subscriptionId }}' --required
;