{ "swagger": "2.0", "info": { "version": "2018-02-01", "title": "TopLevelDomains API Client" }, "host": "management.azure.com", "schemes": [ "https" ], "consumes": [ "application/json" ], "produces": [ "application/json" ], "paths": { "/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains": { "get": { "tags": [ "TopLevelDomains" ], "summary": "Get all top-level domains supported for registration.", "description": "Get all top-level domains supported for registration.", "operationId": "TopLevelDomains_List", "parameters": [ { "$ref": "#/parameters/subscriptionIdParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/TopLevelDomainCollection" } }, "default": { "description": "App Service error response.", "schema": { "$ref": "../../../Microsoft.Web/stable/2018-02-01/CommonDefinitions.json#/definitions/DefaultErrorResponse" } } }, "x-ms-examples": { "List Top Level Domains": { "$ref": "./examples/ListTopLevelDomains.json" } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains/{name}": { "get": { "tags": [ "TopLevelDomains" ], "summary": "Get details of a top-level domain.", "description": "Get details of a top-level domain.", "operationId": "TopLevelDomains_Get", "parameters": [ { "name": "name", "in": "path", "description": "Name of the top-level domain.", "required": true, "type": "string" }, { "$ref": "#/parameters/subscriptionIdParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/TopLevelDomain" } }, "default": { "description": "App Service error response.", "schema": { "$ref": "../../../Microsoft.Web/stable/2018-02-01/CommonDefinitions.json#/definitions/DefaultErrorResponse" } } }, "x-ms-examples": { "Get Top Level Domain": { "$ref": "./examples/GetTopLevelDomain.json" } } } }, "/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains/{name}/listAgreements": { "post": { "tags": [ "TopLevelDomains" ], "summary": "Gets all legal agreements that user needs to accept before purchasing a domain.", "description": "Gets all legal agreements that user needs to accept before purchasing a domain.", "operationId": "TopLevelDomains_ListAgreements", "parameters": [ { "name": "name", "in": "path", "description": "Name of the top-level domain.", "required": true, "type": "string" }, { "name": "agreementOption", "in": "body", "description": "Domain agreement options.", "required": true, "schema": { "$ref": "#/definitions/TopLevelDomainAgreementOption" } }, { "$ref": "#/parameters/subscriptionIdParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/TldLegalAgreementCollection" } }, "default": { "description": "App Service error response.", "schema": { "$ref": "../../../Microsoft.Web/stable/2018-02-01/CommonDefinitions.json#/definitions/DefaultErrorResponse" } } }, "x-ms-examples": { "List Top Level Domain Agreements": { "$ref": "./examples/ListTopLevelDomainAgreements.json" } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } } }, "definitions": { "TldLegalAgreement": { "description": "Legal agreement for a top level domain.", "required": [ "agreementKey", "title", "content" ], "type": "object", "properties": { "agreementKey": { "description": "Unique identifier for the agreement.", "type": "string" }, "title": { "description": "Agreement title.", "type": "string" }, "content": { "description": "Agreement details.", "type": "string" }, "url": { "description": "URL where a copy of the agreement details is hosted.", "type": "string" } } }, "TldLegalAgreementCollection": { "description": "Collection of top-level domain legal agreements.", "required": [ "value" ], "type": "object", "properties": { "value": { "description": "Collection of resources.", "type": "array", "items": { "$ref": "#/definitions/TldLegalAgreement" } }, "nextLink": { "description": "Link to next page of resources.", "type": "string", "readOnly": true } } }, "TopLevelDomain": { "description": "A top level domain object.", "type": "object", "allOf": [ { "$ref": "../../../Microsoft.Web/stable/2018-02-01/CommonDefinitions.json#/definitions/ProxyOnlyResource" } ], "properties": { "properties": { "description": "TopLevelDomain resource specific properties", "properties": { "privacy": { "description": "If true, then the top level domain supports domain privacy; otherwise, false.", "type": "boolean" } }, "x-ms-client-flatten": true } } }, "TopLevelDomainAgreementOption": { "description": "Options for retrieving the list of top level domain legal agreements.", "type": "object", "properties": { "includePrivacy": { "description": "If true, then the list of agreements will include agreements for domain privacy as well; otherwise, false.", "type": "boolean" }, "forTransfer": { "description": "If true, then the list of agreements will include agreements for domain transfer as well; otherwise, false.", "type": "boolean" } } }, "TopLevelDomainCollection": { "description": "Collection of Top-level domains.", "required": [ "value" ], "type": "object", "properties": { "value": { "description": "Collection of resources.", "type": "array", "items": { "$ref": "#/definitions/TopLevelDomain" } }, "nextLink": { "description": "Link to next page of resources.", "type": "string", "readOnly": true } } } }, "parameters": { "subscriptionIdParameter": { "name": "subscriptionId", "in": "path", "description": "Your Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000).", "required": true, "type": "string" }, "apiVersionParameter": { "name": "api-version", "in": "query", "description": "API Version", "required": true, "type": "string" } }, "securityDefinitions": { "azure_auth": { "type": "oauth2", "description": "Azure Active Directory OAuth2 Flow", "flow": "implicit", "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", "scopes": { "user_impersonation": "impersonate your user account" } } }, "security": [ { "azure_auth": [ "user_impersonation" ] } ] }